speexor 0.1.0

package/SUMMARY.md

@@ -0,0 +1,46 @@
+# Speexor — Project Summary
+
+> Agent Orchestrator for multi-AI coding agent orchestration across repositories.
+
+## Project Status
+- **Version:** 0.1.0 (pre-release)
+- **License:** MIT
+- **Language:** TypeScript (ESM, ES2022)
+- **Node.js:** >= 18.0.0
+
+## What It Does
+Speexor is an orchestration layer that spawns and manages multiple AI coding agents in parallel across one or more git repositories. Each agent runs in an isolated git worktree with its own runtime session, handles one task autonomously, and can automatically respond to CI failures and PR review comments.
+
+## Scope
+- **Source files:** 31 TypeScript files (~2,430 lines)
+- **Plugins:** 10 implementations across 6 plugin slots
+- **CLI commands:** 6
+- **AI adapters:** OpenCode, Claude Code, Aider, Codex
+- **Runtime backends:** tmux (Unix), Process (Windows)
+
+## Architecture Highlights
+- Plugin-based: all capabilities are extensions of 7 defined slots
+- Agent-agnostic: no vendor lock to a single AI provider
+- Git-provider agnostic: GitHub as first implementation, interface open for GitLab/Gitea
+- Dashboard built-in: no external dependencies for monitoring
+
+## Milestones
+
+| Milestone | Description | Status |
+|-----------|-------------|--------|
+| M0 — Foundation | Monorepo, core types, CLI skeleton, plugin contracts | ✅ Done |
+| M1 — Single Agent E2E | OpenCode adapter + tmux + worktree, E2E flow | ✅ Done |
+| M2 — GitHub Integration | Tracker + SCM + reaction engine | ✅ Done |
+| M3 — Multi-Agent | Claude Code, Aider, Codex adapters | ✅ Done |
+| M4 — Dashboard MVP | REST API + HTML dashboard | ✅ Done |
+| M5 — Cost/Provider | Multi-provider routing config | 🔄 In Progress |
+| M6 — Polish & Docs | Documentation, examples, open-source readiness | 🔄 In Progress |
+
+## Quick Links
+- [README](./README.md)
+- [Architecture](./ARCHITECTURE.md)
+- [Changelog](./CHANGELOG.md)
+- [Roadmap](./ROADMAP.md)
+- [Contributing](./CONTRIBUTING.md)
+- [Security](./SECURITY.md)
+- [Testing](./TESTING.md)

package/TESTING.md

@@ -0,0 +1,140 @@
+# Testing Guide
+
+> Testing strategy and guidelines for Speexor — Agent Orchestrator.
+
+## Test Framework
+
+Speexor uses [Vitest](https://vitest.dev/) as the test framework with `@vitest/coverage-v8` for coverage reporting.
+
+```bash
+# Run all tests
+pnpm test
+
+# Watch mode
+pnpm test:watch
+
+# With coverage
+pnpm test:coverage
+```
+
+## Test Categories
+
+### Unit Tests
+Test individual modules in isolation:
+- **Core types** — Verify interface contracts and type guards
+- **Config validation** — Test Zod schemas with valid/invalid YAML
+- **Event bus** — Test emit/on/off/once behavior
+- **Plugin contracts** — Verify plugins implement required interfaces
+
+### Integration Tests
+Test module interactions:
+- **Lifecycle + plugins** — Verify plugin registration, agent spawn flow
+- **Config + lifecycle** — Verify config loading → lifecycle initialization
+- **Dashboard state** — Verify state mutations reflect correctly
+- **Session store** — Verify persistence round-trip
+
+### Plugin Tests
+Each plugin should be tested against its interface contract:
+- **Agent plugins** — Test spawn/sendInput/getStatus/kill lifecycle
+- **Runtime plugins** — Test createSession/destroySession flow
+- **Workspace plugin** — Test worktree lifecycle with mock git repo
+- **Tracker/SCM** — Test API calls (mock gh CLI)
+- **Notifier** — Test notification dispatch
+
+### E2E Tests (Future)
+Full end-to-end tests with real agent CLIs:
+- Requires installed agent CLI (opencode, claude-code, etc.)
+- Requires GitHub CLI authentication
+- Creates real worktrees and branches (clean up after)
+
+## Coverage Requirements
+
+| Category | Target |
+|----------|--------|
+| Core types & config | ≥90% |
+| CLI commands | ≥80% |
+| Plugin loader | ≥90% |
+| Agent adapters | ≥75% |
+| Runtime adapters | ≥80% |
+| Dashboard | ≥70% |
+| Reaction engine | ≥85% |
+| Session store | ≥90% |
+
+## Test Structure
+
+```
+tests/
+├── unit/
+│   ├── core/
+│   │   ├── config.test.ts
+│   │   ├── event-bus.test.ts
+│   │   └── lifecycle.test.ts
+│   ├── plugins/
+│   │   ├── opencode.test.ts
+│   │   ├── tmux.test.ts
+│   │   └── git-worktree.test.ts
+│   └── cli/
+│       └── commands.test.ts
+├── integration/
+│   ├── lifecycle-plugins.test.ts
+│   └── config-lifecycle.test.ts
+└── fixtures/
+    ├── valid-config.yaml
+    ├── invalid-config.yaml
+    └── mock-gh-responses/
+```
+
+## Writing Tests
+
+### Vitest Setup
+```typescript
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+```
+
+### Example: Testing Config Validation
+```typescript
+import { validateConfig } from '../src/core/config.js'
+
+describe('Config Validation', () => {
+  it('accepts valid minimal config', () => {
+    const config = {
+      version: '1',
+      projects: [
+        {
+          name: 'test',
+          repository: 'https://github.com/user/repo',
+          provider: { primary: 'opencode' },
+        },
+      ],
+    }
+    expect(() => validateConfig(config)).not.toThrow()
+  })
+
+  it('rejects config without version', () => {
+    expect(() => validateConfig({ projects: [] })).toThrow()
+  })
+})
+```
+
+### Example: Testing Plugin Contract
+```typescript
+import { OpenCodeAgent } from '../src/plugins/agent/opencode.js'
+import { createEventBus } from '../src/core/event-bus.js'
+
+describe('OpenCodeAgent', () => {
+  it('implements AgentPlugin interface', () => {
+    const agent = new OpenCodeAgent()
+    expect(agent.name).toBe('opencode-agent')
+    expect(agent.type).toBe('agent')
+    expect(agent.spawn).toBeInstanceOf(Function)
+    expect(agent.kill).toBeInstanceOf(Function)
+  })
+})
+```
+
+## Mocking Guidelines
+
+- **gh CLI** — Use `vi.mock('node:child_process')` to mock execSync
+- **tmux** — Mock process execution, don't require tmux installation
+- **File system** — Use `vi.mock('node:fs')` for config/store tests
+- **Event bus** — Use real EventBus (not mocked) for integration tests

package/dist/agent-5D3BVWNK.js

@@ -0,0 +1,37 @@
+import { loadConfig, SpeexorLifecycle } from './chunk-2F66BZYJ.js';
+import { loadAllPlugins } from './chunk-B7WLHC4W.js';
+import Debug from 'debug';
+
+var debug = Debug("speexor:agent");
+async function agentSpawnCommand(options) {
+  const config = loadConfig();
+  const lifecycle = new SpeexorLifecycle(config);
+  await lifecycle.initialize();
+  const plugins = loadAllPlugins();
+  for (const plugin of plugins) {
+    lifecycle.registerPlugin(plugin);
+  }
+  const project = config.projects[0];
+  if (!project) {
+    throw new Error("No project configured");
+  }
+  const task = {
+    id: options.task,
+    title: options.task,
+    description: `Task ${options.task}`,
+    repository: project.repository,
+    branch: `speexor/${options.task}`,
+    provider: options.agent || project.provider.primary
+  };
+  debug(`Spawning agent for task ${task.id} using ${task.provider}`);
+  const session = await lifecycle.spawnAgent(task);
+  console.log(`
+  \u2705 Agent spawned: ${session.id}`);
+  console.log(`  \u{1F916} Provider: ${session.provider}`);
+  console.log(`  \u{1F4CB} Task: ${task.id}
+`);
+}
+
+export { agentSpawnCommand };
+//# sourceMappingURL=agent-5D3BVWNK.js.map
+//# sourceMappingURL=agent-5D3BVWNK.js.map

package/dist/agent-5D3BVWNK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/agent.ts"],"names":[],"mappings":";;;;AAMA,IAAM,KAAA,GAAQ,MAAM,eAAe,CAAA;AAOnC,eAAsB,kBAAkB,OAAA,EAAuB;AAC7D,EAAA,MAAM,SAAS,UAAA,EAAW;AAC1B,EAAA,MAAM,SAAA,GAAY,IAAI,gBAAA,CAAiB,MAAM,CAAA;AAC7C,EAAA,MAAM,UAAU,UAAA,EAAW;AAE3B,EAAA,MAAM,UAAU,cAAA,EAAe;AAC/B,EAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,IAAA,SAAA,CAAU,eAAe,MAAM,CAAA;AAAA,EACjC;AAEA,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,QAAA,CAAS,CAAC,CAAA;AACjC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,MAAM,uBAAuB,CAAA;AAAA,EACzC;AAEA,EAAA,MAAM,IAAA,GAAkB;AAAA,IACtB,IAAI,OAAA,CAAQ,IAAA;AAAA,IACZ,OAAO,OAAA,CAAQ,IAAA;AAAA,IACf,WAAA,EAAa,CAAA,KAAA,EAAQ,OAAA,CAAQ,IAAI,CAAA,CAAA;AAAA,IACjC,YAAY,OAAA,CAAQ,UAAA;AAAA,IACpB,MAAA,EAAQ,CAAA,QAAA,EAAW,OAAA,CAAQ,IAAI,CAAA,CAAA;AAAA,IAC/B,QAAA,EAAW,OAAA,CAAQ,KAAA,IAA2B,OAAA,CAAQ,QAAA,CAAS;AAAA,GACjE;AAEA,EAAA,KAAA,CAAM,2BAA2B,IAAA,CAAK,EAAE,CAAA,OAAA,EAAU,IAAA,CAAK,QAAQ,CAAA,CAAE,CAAA;AAEjE,EAAA,MAAM,OAAA,GAAU,MAAM,SAAA,CAAU,UAAA,CAAW,IAAI,CAAA;AAC/C,EAAA,OAAA,CAAQ,GAAA,CAAI;AAAA,wBAAA,EAAwB,OAAA,CAAQ,EAAE,CAAA,CAAE,CAAA;AAChD,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,sBAAA,EAAkB,OAAA,CAAQ,QAAQ,CAAA,CAAE,CAAA;AAChD,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,kBAAA,EAAc,IAAA,CAAK,EAAE;AAAA,CAAI,CAAA;AACvC","file":"agent-5D3BVWNK.js","sourcesContent":["import { loadConfig } from '../core/config.js'\nimport { SpeexorLifecycle } from '../core/lifecycle.js'\nimport { loadAllPlugins } from '../plugins/index.js'\nimport type { AgentTask, AgentProvider } from '../core/types.js'\nimport Debug from 'debug'\n\nconst debug = Debug('speexor:agent')\n\ninterface SpawnOptions {\n  task: string\n  agent: string\n}\n\nexport async function agentSpawnCommand(options: SpawnOptions) {\n  const config = loadConfig()\n  const lifecycle = new SpeexorLifecycle(config)\n  await lifecycle.initialize()\n\n  const plugins = loadAllPlugins()\n  for (const plugin of plugins) {\n    lifecycle.registerPlugin(plugin)\n  }\n\n  const project = config.projects[0]\n  if (!project) {\n    throw new Error('No project configured')\n  }\n\n  const task: AgentTask = {\n    id: options.task,\n    title: options.task,\n    description: `Task ${options.task}`,\n    repository: project.repository,\n    branch: `speexor/${options.task}`,\n    provider: (options.agent as AgentProvider) || project.provider.primary,\n  }\n\n  debug(`Spawning agent for task ${task.id} using ${task.provider}`)\n\n  const session = await lifecycle.spawnAgent(task)\n  console.log(`\\n  ✅ Agent spawned: ${session.id}`)\n  console.log(`  🤖 Provider: ${session.provider}`)\n  console.log(`  📋 Task: ${task.id}\\n`)\n}\n"]}

package/dist/chunk-2F66BZYJ.js

@@ -0,0 +1,212 @@
+import { EventEmitter } from 'eventemitter3';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { parse } from 'yaml';
+import { z } from 'zod';
+import Debug from 'debug';
+
+// src/core/event-bus.ts
+function createEventBus() {
+  const emitter = new EventEmitter();
+  return {
+    emit(event, data) {
+      emitter.emit(event, data);
+    },
+    on(event, handler) {
+      emitter.on(event, handler);
+    },
+    off(event, handler) {
+      emitter.off(event, handler);
+    },
+    once(event, handler) {
+      emitter.once(event, handler);
+    }
+  };
+}
+var reactionRuleSchema = z.object({
+  auto: z.boolean(),
+  action: z.enum(["fix", "notify", "escalate", "skip"]),
+  retries: z.number().int().min(0).max(10),
+  escalateAfter: z.number().int().min(1).max(1440)
+});
+var providerRoutingSchema = z.object({
+  primary: z.enum(["opencode", "claude-code", "aider", "codex"]),
+  fallback: z.array(z.enum(["opencode", "claude-code", "aider", "codex"])).optional(),
+  concurrentLimit: z.number().int().min(1).max(20).optional(),
+  costLimit: z.number().int().optional()
+});
+var projectSchema = z.object({
+  name: z.string().min(1),
+  repository: z.string().min(1),
+  path: z.string().optional(),
+  branch: z.string().optional(),
+  provider: providerRoutingSchema,
+  reactions: z.object({
+    "ci-failed": reactionRuleSchema.optional(),
+    "changes-requested": reactionRuleSchema.optional(),
+    "approved-and-green": reactionRuleSchema.optional()
+  }).optional(),
+  plugins: z.object({
+    tracker: z.string().optional(),
+    scm: z.string().optional(),
+    runtime: z.string().optional(),
+    notifier: z.string().optional()
+  }).optional()
+});
+var configSchema = z.object({
+  version: z.literal("1"),
+  projects: z.array(projectSchema).min(1)
+});
+var DEFAULT_REACTION_RULES = {
+  "ci-failed": { auto: true, action: "fix", retries: 3, escalateAfter: 30 },
+  "changes-requested": { auto: true, action: "fix", retries: 2, escalateAfter: 60 },
+  "approved-and-green": { auto: false, action: "notify", retries: 0, escalateAfter: 0 }
+};
+function loadConfig(cwd) {
+  const dir = cwd ?? process.cwd();
+  const candidates = [
+    join(dir, "speexor.config.yaml"),
+    join(dir, "speexor.config.yml"),
+    join(dir, ".speexor.yaml"),
+    join(dir, ".speexor.yml"),
+    join(dir, "speexor.yaml")
+  ];
+  let configPath;
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      configPath = candidate;
+      break;
+    }
+  }
+  if (!configPath) {
+    throw new Error(`speexor.config.yaml not found in ${dir}. Run \`speexor start <repo>\` to initialize.`);
+  }
+  const raw = readFileSync(configPath, "utf-8");
+  const parsed = parse(raw);
+  return validateConfig(parsed);
+}
+function validateConfig(raw) {
+  const result = configSchema.safeParse(raw);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(`Invalid speexor config:
+${issues}`);
+  }
+  for (const project of result.data.projects) {
+    if (!project.reactions) {
+      project.reactions = { ...DEFAULT_REACTION_RULES };
+    } else {
+      project.reactions = {
+        "ci-failed": project.reactions["ci-failed"] ?? DEFAULT_REACTION_RULES["ci-failed"],
+        "changes-requested": project.reactions["changes-requested"] ?? DEFAULT_REACTION_RULES["changes-requested"],
+        "approved-and-green": project.reactions["approved-and-green"] ?? DEFAULT_REACTION_RULES["approved-and-green"]
+      };
+    }
+  }
+  return result.data;
+}
+function generateDefaultConfig(repoUrl, projectName) {
+  const name = projectName ?? repoUrl.split("/").pop()?.replace(".git", "") ?? "my-project";
+  return {
+    version: "1",
+    projects: [
+      {
+        name,
+        repository: repoUrl,
+        provider: {
+          primary: "opencode"
+        },
+        reactions: { ...DEFAULT_REACTION_RULES }
+      }
+    ]
+  };
+}
+var debug = Debug("speexor:lifecycle");
+var SpeexorLifecycle = class {
+  config;
+  eventBus;
+  plugins = /* @__PURE__ */ new Map();
+  sessions = /* @__PURE__ */ new Map();
+  status = "initializing";
+  constructor(config) {
+    this.config = config;
+    this.eventBus = createEventBus();
+  }
+  async initialize() {
+    debug("Initializing Speexor lifecycle");
+    this.status = "active";
+    this.eventBus.emit("lifecycle:initialized", { timestamp: /* @__PURE__ */ new Date() });
+  }
+  registerPlugin(plugin) {
+    const existing = this.plugins.get(plugin.type) ?? [];
+    existing.push(plugin);
+    this.plugins.set(plugin.type, existing);
+    debug(`Registered plugin: ${plugin.name} (${plugin.type})`);
+  }
+  getPlugins(slot) {
+    return this.plugins.get(slot) ?? [];
+  }
+  getFirstPlugin(slot) {
+    return this.getPlugins(slot)[0];
+  }
+  async spawnAgent(task) {
+    const agentPlugin = this.getFirstPlugin("agent");
+    if (!agentPlugin) throw new Error("No agent plugin registered");
+    const workspacePlugin = this.getFirstPlugin("workspace");
+    if (!workspacePlugin) throw new Error("No workspace plugin registered");
+    const runtimePlugin = this.getFirstPlugin("runtime");
+    if (!runtimePlugin) throw new Error("No runtime plugin registered");
+    const worktree = await workspacePlugin.createWorktree(task);
+    this.eventBus.emit("worktree:created", { taskId: task.id, path: worktree.path });
+    const runtimeSession = await runtimePlugin.createSession(worktree.path);
+    const session = await agentPlugin.spawn(task, runtimeSession);
+    this.sessions.set(session.id, session);
+    this.eventBus.emit("session:created", { session, task });
+    debug(`Agent spawned: ${session.id} for task ${task.id}`);
+    return session;
+  }
+  async stopSession(sessionId) {
+    const session = this.sessions.get(sessionId);
+    if (!session) throw new Error(`Session ${sessionId} not found`);
+    const agentPlugin = this.getFirstPlugin("agent");
+    if (agentPlugin) {
+      await agentPlugin.kill(sessionId);
+    }
+    this.sessions.delete(sessionId);
+    this.eventBus.emit("session:completed", { sessionId });
+    debug(`Session stopped: ${sessionId}`);
+  }
+  getSession(sessionId) {
+    return this.sessions.get(sessionId);
+  }
+  listSessions() {
+    return Array.from(this.sessions.values());
+  }
+  async destroy() {
+    this.status = "completed";
+    for (const [id] of this.sessions) {
+      await this.stopSession(id).catch(() => {
+      });
+    }
+    const slots = ["terminal", "notifier", "scm", "tracker", "workspace", "runtime", "agent"];
+    for (const slot of slots) {
+      const plugins = this.plugins.get(slot) ?? [];
+      for (const plugin of plugins.reverse()) {
+        await plugin.destroy().catch(() => {
+        });
+      }
+    }
+    this.eventBus.emit("lifecycle:destroyed", { timestamp: /* @__PURE__ */ new Date() });
+    debug("Lifecycle destroyed");
+  }
+  getConfig() {
+    return this.config;
+  }
+  getStatus() {
+    return this.status;
+  }
+};
+
+export { DEFAULT_REACTION_RULES, SpeexorLifecycle, createEventBus, generateDefaultConfig, loadConfig, validateConfig };
+//# sourceMappingURL=chunk-2F66BZYJ.js.map
+//# sourceMappingURL=chunk-2F66BZYJ.js.map

package/dist/chunk-2F66BZYJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/event-bus.ts","../src/core/config.ts","../src/core/lifecycle.ts"],"names":[],"mappings":"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","file":"chunk-2F66BZYJ.js","sourcesContent":["import { EventEmitter } from 'eventemitter3'\nimport type { EventBus } from './types.js'\n\nexport function createEventBus(): EventBus {\n  const emitter = new EventEmitter()\n\n  return {\n    emit(event, data) {\n      emitter.emit(event, data)\n    },\n    on(event, handler) {\n      emitter.on(event, handler)\n    },\n    off(event, handler) {\n      emitter.off(event, handler)\n    },\n    once(event, handler) {\n      emitter.once(event, handler)\n    },\n  }\n}\n","import { readFileSync, existsSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { parse } from 'yaml'\nimport { z } from 'zod'\nimport type { SpeexorConfig, ReactionConfig } from './types.js'\n\nconst reactionRuleSchema = z.object({\n  auto: z.boolean(),\n  action: z.enum(['fix', 'notify', 'escalate', 'skip']),\n  retries: z.number().int().min(0).max(10),\n  escalateAfter: z.number().int().min(1).max(1440),\n})\n\nconst providerRoutingSchema = z.object({\n  primary: z.enum(['opencode', 'claude-code', 'aider', 'codex']),\n  fallback: z.array(z.enum(['opencode', 'claude-code', 'aider', 'codex'])).optional(),\n  concurrentLimit: z.number().int().min(1).max(20).optional(),\n  costLimit: z.number().int().optional(),\n})\n\nconst projectSchema = z.object({\n  name: z.string().min(1),\n  repository: z.string().min(1),\n  path: z.string().optional(),\n  branch: z.string().optional(),\n  provider: providerRoutingSchema,\n  reactions: z\n    .object({\n      'ci-failed': reactionRuleSchema.optional(),\n      'changes-requested': reactionRuleSchema.optional(),\n      'approved-and-green': reactionRuleSchema.optional(),\n    })\n    .optional(),\n  plugins: z\n    .object({\n      tracker: z.string().optional(),\n      scm: z.string().optional(),\n      runtime: z.string().optional(),\n      notifier: z.string().optional(),\n    })\n    .optional(),\n})\n\nconst configSchema = z.object({\n  version: z.literal('1'),\n  projects: z.array(projectSchema).min(1),\n})\n\nexport const DEFAULT_REACTION_RULES: ReactionConfig = {\n  'ci-failed': { auto: true, action: 'fix', retries: 3, escalateAfter: 30 },\n  'changes-requested': { auto: true, action: 'fix', retries: 2, escalateAfter: 60 },\n  'approved-and-green': { auto: false, action: 'notify', retries: 0, escalateAfter: 0 },\n}\n\nexport function loadConfig(cwd?: string): SpeexorConfig {\n  const dir = cwd ?? process.cwd()\n\n  const candidates = [\n    join(dir, 'speexor.config.yaml'),\n    join(dir, 'speexor.config.yml'),\n    join(dir, '.speexor.yaml'),\n    join(dir, '.speexor.yml'),\n    join(dir, 'speexor.yaml'),\n  ]\n\n  let configPath: string | undefined\n  for (const candidate of candidates) {\n    if (existsSync(candidate)) {\n      configPath = candidate\n      break\n    }\n  }\n\n  if (!configPath) {\n    throw new Error(`speexor.config.yaml not found in ${dir}. ` + 'Run `speexor start <repo>` to initialize.')\n  }\n\n  const raw = readFileSync(configPath, 'utf-8')\n  const parsed = parse(raw)\n\n  return validateConfig(parsed)\n}\n\nexport function validateConfig(raw: unknown): SpeexorConfig {\n  const result = configSchema.safeParse(raw)\n  if (!result.success) {\n    const issues = result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\\n')\n    throw new Error(`Invalid speexor config:\\n${issues}`)\n  }\n\n  for (const project of result.data.projects) {\n    if (!project.reactions) {\n      ;(project as { reactions: ReactionConfig }).reactions = { ...DEFAULT_REACTION_RULES }\n    } else {\n      project.reactions = {\n        'ci-failed': project.reactions['ci-failed'] ?? DEFAULT_REACTION_RULES['ci-failed'],\n        'changes-requested': project.reactions['changes-requested'] ?? DEFAULT_REACTION_RULES['changes-requested'],\n        'approved-and-green': project.reactions['approved-and-green'] ?? DEFAULT_REACTION_RULES['approved-and-green'],\n      }\n    }\n  }\n\n  return result.data as SpeexorConfig\n}\n\nexport function generateDefaultConfig(repoUrl: string, projectName?: string): SpeexorConfig {\n  const name = projectName ?? repoUrl.split('/').pop()?.replace('.git', '') ?? 'my-project'\n  return {\n    version: '1',\n    projects: [\n      {\n        name,\n        repository: repoUrl,\n        provider: {\n          primary: 'opencode',\n        },\n        reactions: { ...DEFAULT_REACTION_RULES },\n      },\n    ],\n  }\n}\n","import type {\n  SpeexorConfig,\n  AgentPlugin,\n  RuntimePlugin,\n  WorkspacePlugin,\n  AgentTask,\n  AgentSession,\n  SessionStatus,\n  EventBus,\n  PluginModule,\n  PluginSlot,\n} from './types.js'\nimport { createEventBus } from './event-bus.js'\nimport Debug from 'debug'\n\nconst debug = Debug('speexor:lifecycle')\n\nexport class SpeexorLifecycle {\n  private config: SpeexorConfig\n  public eventBus: EventBus\n  private plugins: Map<PluginSlot, PluginModule[]> = new Map()\n  private sessions: Map<string, AgentSession> = new Map()\n  private status: SessionStatus = 'initializing'\n\n  constructor(config: SpeexorConfig) {\n    this.config = config\n    this.eventBus = createEventBus()\n  }\n\n  async initialize(): Promise<void> {\n    debug('Initializing Speexor lifecycle')\n    this.status = 'active'\n    this.eventBus.emit('lifecycle:initialized', { timestamp: new Date() })\n  }\n\n  registerPlugin(plugin: PluginModule): void {\n    const existing = this.plugins.get(plugin.type) ?? []\n    existing.push(plugin)\n    this.plugins.set(plugin.type, existing)\n    debug(`Registered plugin: ${plugin.name} (${plugin.type})`)\n  }\n\n  getPlugins<T extends PluginModule>(slot: PluginSlot): T[] {\n    return (this.plugins.get(slot) ?? []) as T[]\n  }\n\n  getFirstPlugin<T extends PluginModule>(slot: PluginSlot): T | undefined {\n    return this.getPlugins<T>(slot)[0]\n  }\n\n  async spawnAgent(task: AgentTask): Promise<AgentSession> {\n    const agentPlugin = this.getFirstPlugin<AgentPlugin>('agent')\n    if (!agentPlugin) throw new Error('No agent plugin registered')\n\n    const workspacePlugin = this.getFirstPlugin<WorkspacePlugin>('workspace')\n    if (!workspacePlugin) throw new Error('No workspace plugin registered')\n\n    const runtimePlugin = this.getFirstPlugin<RuntimePlugin>('runtime')\n    if (!runtimePlugin) throw new Error('No runtime plugin registered')\n\n    const worktree = await workspacePlugin.createWorktree(task)\n    this.eventBus.emit('worktree:created', { taskId: task.id, path: worktree.path })\n\n    const runtimeSession = await runtimePlugin.createSession(worktree.path)\n\n    const session = await agentPlugin.spawn(task, runtimeSession)\n    this.sessions.set(session.id, session)\n\n    this.eventBus.emit('session:created', { session, task })\n    debug(`Agent spawned: ${session.id} for task ${task.id}`)\n\n    return session\n  }\n\n  async stopSession(sessionId: string): Promise<void> {\n    const session = this.sessions.get(sessionId)\n    if (!session) throw new Error(`Session ${sessionId} not found`)\n\n    const agentPlugin = this.getFirstPlugin<AgentPlugin>('agent')\n    if (agentPlugin) {\n      await agentPlugin.kill(sessionId)\n    }\n\n    this.sessions.delete(sessionId)\n    this.eventBus.emit('session:completed', { sessionId })\n    debug(`Session stopped: ${sessionId}`)\n  }\n\n  getSession(sessionId: string): AgentSession | undefined {\n    return this.sessions.get(sessionId)\n  }\n\n  listSessions(): AgentSession[] {\n    return Array.from(this.sessions.values())\n  }\n\n  async destroy(): Promise<void> {\n    this.status = 'completed'\n\n    for (const [id] of this.sessions) {\n      await this.stopSession(id).catch(() => {})\n    }\n\n    const slots: PluginSlot[] = ['terminal', 'notifier', 'scm', 'tracker', 'workspace', 'runtime', 'agent']\n    for (const slot of slots) {\n      const plugins = this.plugins.get(slot) ?? []\n      for (const plugin of plugins.reverse()) {\n        await plugin.destroy().catch(() => {})\n      }\n    }\n\n    this.eventBus.emit('lifecycle:destroyed', { timestamp: new Date() })\n    debug('Lifecycle destroyed')\n  }\n\n  getConfig(): SpeexorConfig {\n    return this.config\n  }\n\n  getStatus(): SessionStatus {\n    return this.status\n  }\n}\n"]}

package/dist/chunk-5NA2TFPG.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-5NA2TFPG.js.map
+//# sourceMappingURL=chunk-5NA2TFPG.js.map

package/dist/chunk-5NA2TFPG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-5NA2TFPG.js"}