macro-agent 0.1.0 → 0.1.2

package/test_fixtures/fixtures/repos/temp-repo-factory.ts

@@ -1,7 +1,5 @@
 /**
  * TempRepoFactory - Creates temporary git repositories for testing
- *
- * @see s-1zcx Multi-Agent Orchestration Testing Strategy
  */
 
 import * as fs from "fs";
@@ -29,9 +27,6 @@ export async function createTempRepo(
     bare = false,
     remoteOrigin,
     withDataplane = false,
-    withSudocode = false,
-    sudocodeSpecs = [],
-    sudocodeIssues = [],
     branches = [],
   } = options;
 
@@ -123,17 +118,6 @@ export async function createTempRepo(
     // Initialize dataplane schema (minimal for testing)
     initializeDataplaneSchema(db);
 
-    if (withSudocode) {
-      initializeSudocodeSchema(db);
-
-      // Create specs and issues
-      for (const spec of sudocodeSpecs) {
-        createSpec(db, spec);
-      }
-      for (const issue of sudocodeIssues) {
-        createIssue(db, issue);
-      }
-    }
   }
 
   // Build TempRepo object
@@ -313,103 +297,3 @@ function initializeDataplaneSchema(db: Database.Database): void {
   `);
 }
 
-/**
- * Initialize sudocode schema for testing
- */
-function initializeSudocodeSchema(db: Database.Database): void {
-  db.exec(`
-    -- Specs table
-    CREATE TABLE IF NOT EXISTS sudocode_specs (
-      id TEXT PRIMARY KEY,
-      title TEXT NOT NULL,
-      description TEXT,
-      priority INTEGER DEFAULT 2,
-      tags TEXT,
-      created_at INTEGER DEFAULT (unixepoch() * 1000),
-      updated_at INTEGER DEFAULT (unixepoch() * 1000)
-    );
-
-    -- Issues table
-    CREATE TABLE IF NOT EXISTS sudocode_issues (
-      id TEXT PRIMARY KEY,
-      title TEXT NOT NULL,
-      description TEXT,
-      status TEXT DEFAULT 'open',
-      priority INTEGER DEFAULT 2,
-      tags TEXT,
-      created_at INTEGER DEFAULT (unixepoch() * 1000),
-      updated_at INTEGER DEFAULT (unixepoch() * 1000)
-    );
-
-    -- Links table
-    CREATE TABLE IF NOT EXISTS sudocode_links (
-      from_id TEXT NOT NULL,
-      to_id TEXT NOT NULL,
-      type TEXT NOT NULL,
-      created_at INTEGER DEFAULT (unixepoch() * 1000),
-      PRIMARY KEY (from_id, to_id, type)
-    );
-  `);
-}
-
-/**
- * Create a spec in the database
- */
-function createSpec(
-  db: Database.Database,
-  spec: { id?: string; title: string; description?: string; priority?: number; tags?: string[] }
-): string {
-  const id = spec.id || `s-${Date.now().toString(36)}`;
-  db.prepare(`
-    INSERT INTO sudocode_specs (id, title, description, priority, tags)
-    VALUES (?, ?, ?, ?, ?)
-  `).run(
-    id,
-    spec.title,
-    spec.description || "",
-    spec.priority || 2,
-    JSON.stringify(spec.tags || [])
-  );
-  return id;
-}
-
-/**
- * Create an issue in the database
- */
-function createIssue(
-  db: Database.Database,
-  issue: {
-    id?: string;
-    title: string;
-    description?: string;
-    status?: string;
-    priority?: number;
-    implements?: string;
-    tags?: string[];
-  }
-): string {
-  const id = issue.id || `i-${Date.now().toString(36)}`;
-  db.prepare(`
-    INSERT INTO sudocode_issues (id, title, description, status, priority, tags)
-    VALUES (?, ?, ?, ?, ?, ?)
-  `).run(
-    id,
-    issue.title,
-    issue.description || "",
-    issue.status || "open",
-    issue.priority || 2,
-    JSON.stringify(issue.tags || [])
-  );
-
-  // Create implements link if specified
-  if (issue.implements) {
-    db.prepare(`
-      INSERT INTO sudocode_links (from_id, to_id, type)
-      VALUES (?, ?, 'implements')
-    `).run(id, issue.implements);
-  }
-
-  return id;
-}
-
-export { createSpec, createIssue };

package/test_fixtures/fixtures/repos/types.ts

@@ -1,7 +1,5 @@
 /**
  * Types for TempRepoFactory
- *
- * @see s-1zcx Multi-Agent Orchestration Testing Strategy
  */
 
 import type Database from "better-sqlite3";
@@ -25,15 +23,6 @@ export interface TempRepoOptions {
   /** Initialize dataplane schema (creates SQLite database) */
   withDataplane?: boolean;
 
-  /** Initialize sudocode (requires withDataplane) */
-  withSudocode?: boolean;
-
-  /** Sudocode specs to create */
-  sudocodeSpecs?: PartialSpec[];
-
-  /** Sudocode issues to create */
-  sudocodeIssues?: PartialIssue[];
-
   /** Additional branches to create */
   branches?: BranchConfig[];
 }

package/test_fixtures/harness/__tests__/fixtures.test.ts

@@ -1,9 +1,7 @@
 /**
  * Fixtures Library Tests
  *
- * Tests for project fixtures, behavior fixtures, and sudocode fixtures.
- *
- * @see s-1zcx Multi-Agent Orchestration Testing Strategy
+ * Tests for project fixtures and behavior fixtures.
  */
 
 import { describe, it, expect, afterEach } from "vitest";
@@ -29,12 +27,6 @@ import {
   SIMPLE_INTEGRATOR,
   SIMPLE_MONITOR,
   createWorker,
-  // Sudocode fixtures
-  SIMPLE_FEATURE_SPEC,
-  AUTH_SPEC,
-  AUTH_ISSUES,
-  createSpec,
-  createIssue,
 } from "../../fixtures/index.js";
 
 describe("Fixtures Library", () => {
@@ -97,23 +89,19 @@ describe("Fixtures Library", () => {
       expect(repo.readFile("index.ts")).toContain("version");
     });
 
-    it("should create project with specs", async () => {
+    it("should create project with dataplane", async () => {
       harness = await createTestHarness();
       const repo = await harness.createTempRepo(PROJECT_WITH_SPECS);
 
       expect(repo.db).toBeDefined();
 
-      // Verify specs were created
-      const specs = repo.db!
-        .prepare("SELECT * FROM sudocode_specs")
-        .all() as Array<{ id: string }>;
-      expect(specs.length).toBeGreaterThan(0);
-
-      // Verify issues were created
-      const issues = repo.db!
-        .prepare("SELECT * FROM sudocode_issues")
-        .all() as Array<{ id: string }>;
-      expect(issues.length).toBeGreaterThan(0);
+      // Verify dataplane tables exist
+      const tables = repo.db!
+        .prepare(
+          "SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'dataplane_%'"
+        )
+        .all() as Array<{ name: string }>;
+      expect(tables.length).toBeGreaterThan(0);
     });
 
     it("should create custom TypeScript project options", async () => {
@@ -308,77 +296,6 @@ describe("Fixtures Library", () => {
     });
   });
 
-  // ─────────────────────────────────────────────────────────────────────────
-  // Sudocode Fixtures
-  // ─────────────────────────────────────────────────────────────────────────
-
-  describe("Sudocode Fixtures", () => {
-    let harness: TestHarness;
-
-    afterEach(async () => {
-      if (harness) {
-        await harness.cleanup();
-      }
-    });
-
-    it("should create project with predefined specs", async () => {
-      harness = await createTestHarness();
-      const repo = await harness.createTempRepo({
-        initialFiles: MINIMAL_PROJECT,
-        withDataplane: true,
-        withSudocode: true,
-        sudocodeSpecs: [SIMPLE_FEATURE_SPEC, AUTH_SPEC],
-      });
-
-      const specs = repo.db!
-        .prepare("SELECT * FROM sudocode_specs")
-        .all() as Array<{ id: string; title: string }>;
-
-      expect(specs.length).toBe(2);
-      expect(specs.some((s) => s.title === "Simple Feature")).toBe(true);
-      expect(specs.some((s) => s.title === "User Authentication")).toBe(true);
-    });
-
-    it("should create project with predefined issues", async () => {
-      harness = await createTestHarness();
-      const repo = await harness.createTempRepo({
-        initialFiles: MINIMAL_PROJECT,
-        withDataplane: true,
-        withSudocode: true,
-        sudocodeSpecs: [AUTH_SPEC],
-        sudocodeIssues: AUTH_ISSUES,
-      });
-
-      const issues = repo.db!
-        .prepare("SELECT * FROM sudocode_issues")
-        .all() as Array<{ id: string; title: string }>;
-
-      expect(issues.length).toBe(4); // 4 auth issues
-    });
-
-    it("should create custom spec", () => {
-      const spec = createSpec("s-custom", "Custom Spec", "Custom description", {
-        priority: 1,
-        tags: ["custom"],
-      });
-
-      expect(spec.id).toBe("s-custom");
-      expect(spec.title).toBe("Custom Spec");
-      expect(spec.priority).toBe(1);
-    });
-
-    it("should create custom issue", () => {
-      const issue = createIssue("i-custom", "Custom Issue", {
-        implements: "s-custom",
-        status: "in_progress",
-      });
-
-      expect(issue.id).toBe("i-custom");
-      expect(issue.title).toBe("Custom Issue");
-      expect(issue.implements).toBe("s-custom");
-    });
-  });
-
   // ─────────────────────────────────────────────────────────────────────────
   // Integration Tests
   // ─────────────────────────────────────────────────────────────────────────
@@ -395,19 +312,10 @@ describe("Fixtures Library", () => {
     it("should run complete workflow with fixtures", async () => {
       harness = await createTestHarness();
 
-      // Create project with specs
+      // Create project
       await harness.createTempRepo({
         initialFiles: TYPESCRIPT_PROJECT,
         withDataplane: true,
-        withSudocode: true,
-        sudocodeSpecs: [SIMPLE_FEATURE_SPEC],
-        sudocodeIssues: [
-          {
-            id: "i-impl",
-            title: "Implement feature",
-            implements: "s-simple",
-          },
-        ],
       });
 
       // Spawn coordinator that spawns worker

package/test_fixtures/harness/__tests__/temp-repo-and-simulator.test.ts

@@ -111,39 +111,6 @@ describe("TempRepoFactory and AgentSimulator", () => {
       expect(tables.length).toBeGreaterThan(0);
     });
 
-    it("should create repo with sudocode schema and fixtures", async () => {
-      repo = await createTempRepo({
-        withDataplane: true,
-        withSudocode: true,
-        sudocodeSpecs: [
-          { id: "s-test", title: "Test Spec", description: "Test description" },
-        ],
-        sudocodeIssues: [
-          { id: "i-test", title: "Test Issue", implements: "s-test" },
-        ],
-      });
-
-      // Verify spec was created
-      const spec = repo.db!
-        .prepare("SELECT * FROM sudocode_specs WHERE id = ?")
-        .get("s-test") as { title: string } | undefined;
-      expect(spec).toBeDefined();
-      expect(spec!.title).toBe("Test Spec");
-
-      // Verify issue was created
-      const issue = repo.db!
-        .prepare("SELECT * FROM sudocode_issues WHERE id = ?")
-        .get("i-test") as { title: string } | undefined;
-      expect(issue).toBeDefined();
-      expect(issue!.title).toBe("Test Issue");
-
-      // Verify link was created
-      const link = repo.db!
-        .prepare("SELECT * FROM sudocode_links WHERE from_id = ? AND to_id = ?")
-        .get("i-test", "s-test") as { type: string } | undefined;
-      expect(link).toBeDefined();
-      expect(link!.type).toBe("implements");
-    });
   });
 
   // ─────────────────────────────────────────────────────────────────────────

package/test_fixtures/harness/simulator/agent-simulator.ts

@@ -155,9 +155,9 @@ class DefaultAgentSimulator implements AgentSimulator {
   async stop(): Promise<void> {
     if (!this.running) return;
 
-    // Emit terminate event
+    // Emit stop event
     this.services.eventStore.emit({
-      type: "terminate",
+      type: "stop",
       source: { agent_id: this.agentId },
       payload: {
         agent_id: this.agentId,
@@ -753,9 +753,9 @@ class DefaultAgentSimulator implements AgentSimulator {
       });
     }
 
-    // Emit terminate event
+    // Emit stop event
     this.services.eventStore.emit({
-      type: "terminate",
+      type: "stop",
       source: { agent_id: this.agentId },
       payload: {
         agent_id: this.agentId,

package/vitest.config.ts

@@ -22,7 +22,7 @@ export default defineConfig({
     },
     server: {
       deps: {
-        // Force inline the sudocode packages to avoid Node.js type stripping issues
+        // Force inline external packages to avoid Node.js type stripping issues
         inline: [/@sudocode-ai\/.*/],
       },
     },

package/vitest.e2e.config.ts

@@ -20,7 +20,7 @@ export default defineConfig({
     fileParallelism: false,
     server: {
       deps: {
-        // Force inline the sudocode packages to avoid Node.js type stripping issues
+        // Force inline external packages to avoid Node.js type stripping issues
         inline: [/@sudocode-ai\/.*/],
       },
     },

package/vitest.setup.ts

@@ -6,36 +6,7 @@
 
 import { beforeAll, vi } from "vitest";
 
-// Store the real project path
-const REAL_PROJECT_PATH = process.cwd();
-
-/**
- * Safety check: Prevent tests from accidentally using the real project's
- * sudocode directory by intercepting StandaloneClient creation.
- *
- * Tests that need to use sudocode should use temp directories.
- */
 beforeAll(() => {
-  // Track original module for potential restoration
-  const originalCwd = process.cwd;
-
-  // Create a spy on process.cwd that tracks calls
-  // This helps identify if any test is trying to use the real project
-  const cwdSpy = vi.spyOn(process, "cwd");
-
-  // We can't fully prevent process.cwd() from being called, but we can
-  // set up the environment to make it clear we're in a test
+  // Set up the environment to make it clear we're in a test
   process.env.NODE_ENV = "test";
-
-  // Log a warning if MACRO_TASK_BACKEND=sudocode without explicit path
-  if (
-    process.env.MACRO_TASK_BACKEND === "sudocode" &&
-    !process.env.SUDOCODE_PROJECT_PATH
-  ) {
-    console.warn(
-      "\n⚠️  WARNING: MACRO_TASK_BACKEND=sudocode but SUDOCODE_PROJECT_PATH is not set.\n" +
-        "   Tests may accidentally modify the real project's .sudocode/ directory.\n" +
-        "   Set SUDOCODE_PROJECT_PATH to a temp directory for safety.\n"
-    );
-  }
 });

package/.macro-agent/teams/self-driving/prompts/grinder.md

@@ -1,27 +0,0 @@
-# Grinder
-
-You are a Grinder — an autonomous worker that claims tasks and executes them.
-
-## How You Work
-
-1. Call claim_task() to get your next task
-2. Read the task description carefully
-3. Execute the work: write code, run tests, fix issues
-4. When done, call done() with your results
-5. Immediately call claim_task() for the next task
-6. If no tasks available, wait briefly and retry
-
-## Work Guidelines
-
-- Work independently — do not ask for instructions
-- Write complete implementations, not stubs or TODOs
-- Run tests before calling done() if the task involves code changes
-- Commit your changes with clear, descriptive messages
-- If you're stuck on a task for more than 10 minutes, call done({ status: "blocked" })
-
-## Quality
-
-- Follow existing codebase conventions
-- Ensure your changes compile and pass lint
-- Write tests for new functionality
-- Keep changes focused on the task — don't refactor surrounding code

package/.macro-agent/teams/self-driving/prompts/judge.md

@@ -1,27 +0,0 @@
-# Judge
-
-You periodically evaluate the health of the codebase and take corrective action.
-
-## Evaluation Cycle
-
-Every time you activate:
-1. Run the build — check compilation
-2. Run the test suite — check correctness
-3. Run the linter — check code quality
-4. If all pass: emit GREEN_SNAPSHOT
-5. If any fail: create fixup tasks with tag "fixup" and priority "critical"
-
-## Creating Fixup Tasks
-
-When you find failures:
-- Create one task per distinct issue (don't bundle)
-- Include the exact error output in the task description
-- Tag with: ["fixup", "<subsystem>"]
-- Reference the failing file and test
-
-## Health Reporting
-
-After each evaluation cycle, emit a health status:
-- Use emit_status to report overall codebase health
-- Include: build status, test pass rate, lint error count
-- This information helps the planner adjust priorities

package/.macro-agent/teams/self-driving/prompts/planner.md

@@ -1,33 +0,0 @@
-# Planner
-
-You are the Planner. Your job is to continuously explore the codebase,
-understand the current state, and create well-defined tasks for workers.
-
-## How You Work
-
-1. **Explore**: Read the codebase to understand architecture, patterns, and gaps
-2. **Plan**: Break the objective into independent, parallelizable tasks
-3. **Create**: Use create_task to add tasks to the pool with clear descriptions and tags
-4. **Monitor**: Watch for completed/failed tasks and adjust the plan
-5. **Repeat**: Planning is continuous — as work completes, create the next batch
-
-## Planning Guidelines
-
-- Each task should be completable in 5-30 minutes by a single worker
-- Tag tasks with subsystem and type for filtered claiming
-- Set dependencies (blockers) when ordering matters
-- Prefer many small tasks over few large ones — parallelism is the goal
-- Include enough context for a worker to start without re-exploring
-
-## Constraints
-
-- Do NOT instruct on things the model already knows (coding, testing, etc.)
-- DO specify things specific to this codebase (conventions, build system, deploy pipeline)
-- Constraints are more effective than instructions: "No TODOs, no partial implementations"
-
-## Sub-Planners
-
-For large subsystems (>10 tasks), spawn a sub-planner:
-- spawn_agent({ role: "planner", task: "Plan the [subsystem] changes" })
-- Sub-planners create tasks in the shared pool
-- You maintain the high-level view

package/.macro-agent/teams/self-driving/roles/grinder.yaml

@@ -1,17 +0,0 @@
-name: grinder
-extends: worker
-display_name: "Grinder"
-description: "Claims and executes tasks autonomously"
-
-capabilities_add:
-  - task.claim
-  - git.push
-
-prompt: prompts/grinder.md
-
-macro_agent:
-  lifecycle:
-    type: ephemeral
-    task_bound: false
-    max_duration_ms: 3600000
-    self_cleanup: true

package/.macro-agent/teams/self-driving/roles/judge.yaml

@@ -1,24 +0,0 @@
-name: judge
-extends: monitor
-display_name: "Judge"
-description: "Periodically evaluates codebase health and creates fixup tasks"
-
-capabilities_add:
-  - exec.build
-  - exec.test
-  - exec.lint
-  - task.create
-  - task.update
-  - git.branch.create
-  - git.push
-
-prompt: prompts/judge.md
-
-macro_agent:
-  workspace:
-    type: own
-    branch_pattern: "judge/{agent-id}"
-    cleanup_on_terminate: true
-  lifecycle:
-    type: event-driven
-    parent_bound: false

package/.macro-agent/teams/self-driving/roles/planner.yaml

@@ -1,18 +0,0 @@
-name: planner
-extends: coordinator
-display_name: "Planner"
-description: "Continuously explores the codebase, creates and prioritizes tasks"
-
-capabilities_add:
-  - task.claim
-
-capabilities_remove:
-  - agent.spawn.integrator
-  - agent.spawn.monitor
-
-prompt: prompts/planner.md
-
-macro_agent:
-  lifecycle:
-    type: daemon
-    cascade_terminate: true