macro-agent 0.2.4 → 0.2.6

package/test_fixtures/fixtures/behaviors/coordinators.ts

@@ -1,196 +0,0 @@
-/**
- * Coordinator Behavior Fixtures
- *
- * Predefined behaviors for coordinator agents.
- *
- * @see s-1zcx Multi-Agent Orchestration Testing Strategy
- * @see i-7f2l Phase 4: Fixtures Library
- */
-
-import type { SimulatedBehavior, BehaviorStep } from "../../harness/simulator/types.js";
-import { SUCCESSFUL_WORKER } from "./workers.js";
-
-/**
- * Basic planning coordinator - spawns workers and waits
- */
-export const PLANNING_COORDINATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Planning work distribution" },
-    {
-      type: "call_tool",
-      tool: "create_task",
-      params: { description: "Task 1: Implement feature A" },
-      storeResult: "task1",
-    },
-    {
-      type: "call_tool",
-      tool: "create_task",
-      params: { description: "Task 2: Implement feature B" },
-      storeResult: "task2",
-    },
-    { type: "log", message: "Spawning workers" },
-    {
-      type: "spawn_child",
-      role: "worker",
-      behavior: SUCCESSFUL_WORKER,
-    },
-    { type: "log", message: "Waiting for workers" },
-    { type: "wait_for_event", event: "WORKERS_COMPLETE" },
-    { type: "done", status: "completed", summary: "Coordination complete" },
-  ],
-};
-
-/**
- * Coordinator that spawns multiple workers
- */
-export function createMultiWorkerCoordinator(
-  workerCount: number,
-  workerBehavior: SimulatedBehavior = SUCCESSFUL_WORKER
-): SimulatedBehavior {
-  const steps: BehaviorStep[] = [
-    { type: "log", message: `Spawning ${workerCount} workers` },
-  ];
-
-  for (let i = 0; i < workerCount; i++) {
-    steps.push({
-      type: "spawn_child",
-      role: "worker",
-      behavior: workerBehavior,
-    });
-  }
-
-  steps.push(
-    { type: "log", message: "All workers spawned" },
-    { type: "done", status: "completed", summary: `Spawned ${workerCount} workers` }
-  );
-
-  return { onStart: steps };
-}
-
-/**
- * Coordinator that waits for all children to complete
- */
-export const WAITING_COORDINATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting coordination" },
-    {
-      type: "spawn_child",
-      role: "worker",
-      behavior: {
-        onStart: [
-          { type: "log", message: "Worker 1 working" },
-          { type: "emit_signal", signal: "worker_done", payload: { id: 1 } },
-          { type: "done", status: "completed" },
-        ],
-      },
-    },
-    {
-      type: "spawn_child",
-      role: "worker",
-      behavior: {
-        onStart: [
-          { type: "log", message: "Worker 2 working" },
-          { type: "emit_signal", signal: "worker_done", payload: { id: 2 } },
-          { type: "done", status: "completed" },
-        ],
-      },
-    },
-    { type: "wait_for_event", event: "ALL_WORKERS_DONE" },
-    { type: "done", status: "completed" },
-  ],
-};
-
-/**
- * Coordinator with conditional spawning
- */
-export const CONDITIONAL_COORDINATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Checking conditions" },
-    {
-      type: "conditional",
-      if: (ctx) => ctx.variables.get("needsWorker") === true,
-      then: [
-        { type: "log", message: "Spawning worker" },
-        { type: "spawn_child", role: "worker", behavior: SUCCESSFUL_WORKER },
-      ],
-      else: [
-        { type: "log", message: "No worker needed" },
-      ],
-    },
-    { type: "done", status: "completed" },
-  ],
-};
-
-/**
- * Coordinator that handles worker events
- */
-export const EVENT_HANDLING_COORDINATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting event-driven coordination" },
-    {
-      type: "spawn_child",
-      role: "worker",
-      behavior: {
-        onStart: [
-          { type: "log", message: "Worker starting" },
-          { type: "emit_signal", signal: "status", payload: { status: "started" } },
-          { type: "write_file", path: "output.txt", content: "done" },
-          { type: "emit_signal", signal: "status", payload: { status: "completed" } },
-          { type: "done", status: "completed" },
-        ],
-      },
-    },
-  ],
-  onEvent: {
-    worker_status: [
-      { type: "log", message: "Received worker status update" },
-    ],
-    worker_error: [
-      { type: "log", message: "Worker reported error - handling" },
-    ],
-  },
-};
-
-/**
- * Coordinator that creates tasks and assigns workers
- */
-export const TASK_CREATING_COORDINATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Creating tasks" },
-    {
-      type: "call_tool",
-      tool: "create_task",
-      params: { description: "Implement authentication" },
-      storeResult: "authTask",
-    },
-    {
-      type: "call_tool",
-      tool: "create_task",
-      params: { description: "Implement database layer" },
-      storeResult: "dbTask",
-    },
-    {
-      type: "call_tool",
-      tool: "create_task",
-      params: { description: "Implement API endpoints" },
-      storeResult: "apiTask",
-    },
-    { type: "log", message: "Tasks created, spawning workers" },
-    {
-      type: "spawn_child",
-      role: "worker",
-      behavior: SUCCESSFUL_WORKER,
-    },
-    { type: "done", status: "completed", summary: "Tasks created and distributed" },
-  ],
-};
-
-/**
- * Simple coordinator that just completes
- */
-export const SIMPLE_COORDINATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Simple coordinator running" },
-    { type: "done", status: "completed" },
-  ],
-};

package/test_fixtures/fixtures/behaviors/index.ts

@@ -1,62 +0,0 @@
-/**
- * Behavior Fixtures exports
- *
- * @see s-1zcx Multi-Agent Orchestration Testing Strategy
- * @see i-7f2l Phase 4: Fixtures Library
- */
-
-// Workers
-export {
-  SUCCESSFUL_WORKER,
-  FAILING_WORKER,
-  STUCK_WORKER,
-  IMPLEMENT_FUNCTION_WORKER,
-  WAITING_WORKER,
-  SIGNALING_WORKER,
-  MULTI_COMMIT_WORKER,
-  BLOCKED_WORKER,
-  DEFERRED_WORKER,
-  HELP_EMITTING_WORKER,
-  EXPLICIT_FAILING_WORKER,
-  createConflictingWorker,
-  createWorker,
-  createUniqueFileWorker,
-  // Resolver workers
-  RESOLVER_WORKER,
-  FAILING_RESOLVER_WORKER,
-  NESTED_CONFLICT_RESOLVER,
-  createResolverWorker,
-} from "./workers.js";
-
-// Coordinators
-export {
-  PLANNING_COORDINATOR,
-  WAITING_COORDINATOR,
-  CONDITIONAL_COORDINATOR,
-  EVENT_HANDLING_COORDINATOR,
-  TASK_CREATING_COORDINATOR,
-  SIMPLE_COORDINATOR,
-  createMultiWorkerCoordinator,
-} from "./coordinators.js";
-
-// Integrators
-export {
-  BASIC_INTEGRATOR,
-  CONFLICT_RESOLVER,
-  BATCH_INTEGRATOR,
-  VALIDATING_INTEGRATOR,
-  CONTINUOUS_INTEGRATOR,
-  SIMPLE_INTEGRATOR,
-  FAILING_INTEGRATOR,
-} from "./integrators.js";
-
-// Monitors
-export {
-  HEALTH_CHECK_MONITOR,
-  GUPP_MONITOR,
-  PROGRESS_MONITOR,
-  TIMEOUT_MONITOR,
-  RESOURCE_MONITOR,
-  SIMPLE_MONITOR,
-  PERSISTENT_MONITOR,
-} from "./monitors.js";

package/test_fixtures/fixtures/behaviors/integrators.ts

@@ -1,143 +0,0 @@
-/**
- * Integrator Behavior Fixtures
- *
- * Predefined behaviors for integrator agents.
- *
- * @see s-1zcx Multi-Agent Orchestration Testing Strategy
- * @see i-7f2l Phase 4: Fixtures Library
- */
-
-import type { SimulatedBehavior } from "../../harness/simulator/types.js";
-
-/**
- * Basic integrator - processes queue and merges
- */
-export const BASIC_INTEGRATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting integration process" },
-    { type: "log", message: "Checking merge queue" },
-    { type: "wait_for_event", event: "MERGE_REQUEST_READY" },
-    { type: "log", message: "Processing merge request" },
-    { type: "emit_signal", signal: "merge_started", payload: {} },
-    { type: "log", message: "Merge completed" },
-    { type: "emit_signal", signal: "merge_completed", payload: { success: true } },
-    { type: "done", status: "completed", summary: "Integration complete" },
-  ],
-};
-
-/**
- * Integrator that handles conflicts
- */
-export const CONFLICT_RESOLVER: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting conflict resolution" },
-    { type: "wait_for_event", event: "CONFLICT_DETECTED" },
-    { type: "log", message: "Conflict detected, analyzing" },
-    { type: "log", message: "Attempting automatic resolution" },
-    {
-      type: "conditional",
-      if: (ctx) => ctx.variables.get("canAutoResolve") === true,
-      then: [
-        { type: "log", message: "Auto-resolving conflict" },
-        { type: "emit_signal", signal: "conflict_resolved", payload: { auto: true } },
-      ],
-      else: [
-        { type: "log", message: "Manual resolution required" },
-        { type: "emit_signal", signal: "manual_resolution_needed", payload: {} },
-      ],
-    },
-    { type: "done", status: "completed" },
-  ],
-};
-
-/**
- * Integrator that waits for all merge requests
- */
-export const BATCH_INTEGRATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting batch integration" },
-    { type: "emit_signal", signal: "collecting_requests", payload: {} },
-    { type: "wait_for_event", event: "BATCH_READY" },
-    { type: "log", message: "Processing batch" },
-    { type: "log", message: "Merging request 1" },
-    { type: "log", message: "Merging request 2" },
-    { type: "log", message: "Merging request 3" },
-    { type: "emit_signal", signal: "batch_merged", payload: { count: 3 } },
-    { type: "done", status: "completed", summary: "Batch of 3 merged" },
-  ],
-};
-
-/**
- * Integrator that validates before merging
- */
-export const VALIDATING_INTEGRATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting validated integration" },
-    { type: "wait_for_event", event: "MERGE_REQUEST" },
-    { type: "log", message: "Running validation checks" },
-    { type: "emit_signal", signal: "running_tests", payload: {} },
-    {
-      type: "conditional",
-      if: (ctx) => ctx.variables.get("testsPass") !== false,
-      then: [
-        { type: "log", message: "Tests passed, proceeding with merge" },
-        { type: "emit_signal", signal: "merge_approved", payload: {} },
-      ],
-      else: [
-        { type: "log", message: "Tests failed, rejecting merge" },
-        { type: "emit_signal", signal: "merge_rejected", payload: { reason: "tests_failed" } },
-      ],
-    },
-    { type: "done", status: "completed" },
-  ],
-};
-
-/**
- * Integrator that processes queue continuously
- */
-export const CONTINUOUS_INTEGRATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting continuous integration" },
-    { type: "emit_signal", signal: "integrator_ready", payload: {} },
-  ],
-  onEvent: {
-    NEW_MERGE_REQUEST: [
-      { type: "log", message: "New merge request received" },
-      { type: "emit_signal", signal: "processing", payload: {} },
-      { type: "emit_signal", signal: "merged", payload: {} },
-    ],
-  },
-  conditions: [
-    {
-      condition: (ctx) => ctx.variables.get("shutdown") === true,
-      behavior: [
-        { type: "log", message: "Shutdown requested" },
-        { type: "done", status: "completed", summary: "Shutdown complete" },
-      ],
-      once: true,
-    },
-  ],
-};
-
-/**
- * Simple integrator that just completes
- */
-export const SIMPLE_INTEGRATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Simple integrator running" },
-    { type: "done", status: "completed" },
-  ],
-};
-
-/**
- * Integrator that fails on conflict
- */
-export const FAILING_INTEGRATOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting integration" },
-    { type: "wait_for_event", event: "MERGE_REQUEST" },
-    { type: "log", message: "Attempting merge" },
-  ],
-  failAfter: 3,
-  failWith: "Merge conflict could not be resolved",
-};

package/test_fixtures/fixtures/behaviors/monitors.ts

@@ -1,199 +0,0 @@
-/**
- * Monitor Behavior Fixtures
- *
- * Predefined behaviors for monitor agents.
- *
- * @see s-1zcx Multi-Agent Orchestration Testing Strategy
- * @see i-7f2l Phase 4: Fixtures Library
- */
-
-import type { SimulatedBehavior } from "../../harness/simulator/types.js";
-
-/**
- * Health check monitor - periodic checks for stuck agents
- */
-export const HEALTH_CHECK_MONITOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting health check monitor" },
-    { type: "emit_signal", signal: "monitor_started", payload: { type: "health" } },
-  ],
-  onEvent: {
-    CHECK_HEALTH: [
-      { type: "log", message: "Running health check" },
-      {
-        type: "conditional",
-        if: (ctx) => ctx.stuckAgents.length > 0,
-        then: [
-          { type: "log", message: "Stuck agents detected" },
-          {
-            type: "emit_signal",
-            signal: "stuck_agents_detected",
-            payload: {},
-          },
-        ],
-        else: [
-          { type: "log", message: "All agents healthy" },
-        ],
-      },
-    ],
-  },
-  conditions: [
-    {
-      condition: (ctx) => ctx.variables.get("shutdown") === true,
-      behavior: [
-        { type: "log", message: "Health monitor shutting down" },
-        { type: "done", status: "completed" },
-      ],
-      once: true,
-    },
-  ],
-};
-
-/**
- * GUPP violation monitor
- */
-export const GUPP_MONITOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting GUPP monitor" },
-    { type: "emit_signal", signal: "monitor_started", payload: { type: "gupp" } },
-  ],
-  onEvent: {
-    COMMIT_DETECTED: [
-      { type: "log", message: "Checking commit for GUPP violations" },
-      {
-        type: "conditional",
-        if: (ctx) => {
-          const commit = ctx.variables.get("lastCommit") as { files?: string[] } | undefined;
-          // Simple GUPP check - multiple files in one commit
-          return (commit?.files?.length ?? 0) > 5;
-        },
-        then: [
-          { type: "log", message: "GUPP violation: too many files in commit" },
-          { type: "emit_signal", signal: "gupp_violation", payload: { type: "commit_size" } },
-        ],
-        else: [
-          { type: "log", message: "Commit passes GUPP check" },
-        ],
-      },
-    ],
-    BRANCH_CREATED: [
-      { type: "log", message: "Checking branch naming" },
-    ],
-  },
-  conditions: [
-    {
-      condition: (ctx) => ctx.variables.get("shutdown") === true,
-      behavior: [
-        { type: "log", message: "GUPP monitor shutting down" },
-        { type: "done", status: "completed" },
-      ],
-      once: true,
-    },
-  ],
-};
-
-/**
- * Progress monitor - tracks task completion
- */
-export const PROGRESS_MONITOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting progress monitor" },
-    { type: "emit_signal", signal: "monitor_started", payload: { type: "progress" } },
-  ],
-  onEvent: {
-    TASK_COMPLETED: [
-      { type: "log", message: "Task completed, updating progress" },
-      { type: "emit_signal", signal: "progress_updated", payload: {} },
-    ],
-    TASK_FAILED: [
-      { type: "log", message: "Task failed, reporting" },
-      { type: "emit_signal", signal: "failure_reported", payload: {} },
-    ],
-  },
-  conditions: [
-    {
-      condition: (ctx) => ctx.variables.get("allTasksComplete") === true,
-      behavior: [
-        { type: "log", message: "All tasks complete" },
-        { type: "emit_signal", signal: "all_complete", payload: {} },
-        { type: "done", status: "completed" },
-      ],
-      once: true,
-    },
-  ],
-};
-
-/**
- * Timeout monitor - watches for stuck operations
- */
-export const TIMEOUT_MONITOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting timeout monitor" },
-  ],
-  onEvent: {
-    OPERATION_STARTED: [
-      { type: "log", message: "Recording operation start time" },
-    ],
-    CHECK_TIMEOUTS: [
-      { type: "log", message: "Checking for timeouts" },
-      {
-        type: "conditional",
-        if: (ctx) => {
-          const startTime = ctx.variables.get("operationStartTime") as number | undefined;
-          if (!startTime) return false;
-          return Date.now() - startTime > 60000; // 60 second timeout
-        },
-        then: [
-          { type: "log", message: "Operation timeout detected" },
-          { type: "emit_signal", signal: "timeout_detected", payload: {} },
-        ],
-      },
-    ],
-  },
-};
-
-/**
- * Resource monitor - watches resource usage
- */
-export const RESOURCE_MONITOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Starting resource monitor" },
-  ],
-  onEvent: {
-    CHECK_RESOURCES: [
-      { type: "log", message: "Checking resource usage" },
-      { type: "emit_signal", signal: "resource_report", payload: { cpu: "ok", memory: "ok" } },
-    ],
-  },
-  conditions: [
-    {
-      condition: (ctx) => ctx.variables.get("shutdown") === true,
-      behavior: [
-        { type: "done", status: "completed" },
-      ],
-      once: true,
-    },
-  ],
-};
-
-/**
- * Simple monitor that completes immediately
- */
-export const SIMPLE_MONITOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Simple monitor check" },
-    { type: "done", status: "completed" },
-  ],
-};
-
-/**
- * Monitor that waits for shutdown signal
- */
-export const PERSISTENT_MONITOR: SimulatedBehavior = {
-  onStart: [
-    { type: "log", message: "Persistent monitor started" },
-    { type: "wait_for_event", event: "SHUTDOWN" },
-    { type: "log", message: "Shutdown received" },
-    { type: "done", status: "completed" },
-  ],
-};