heyio 3.0.2 → 3.0.3

package/src/squad/execution/tasks.ts

@@ -1,111 +0,0 @@
-import { createChildLogger } from '../../logging/logger.js';
-import type { Agent } from '../agent.js';
-import { getEventBus } from '../event-bus.js';
-import type { SquadRuntime } from '../manager.js';
-import { type Instance, type InstanceTask, transitionInstance } from './instance.js';
-
-const logger = () => createChildLogger('task-exec');
-
-/**
- * Execute all tasks in an instance sequentially.
- * Team lead reviews each completed task before moving to the next.
- */
-export async function executeTasks(params: {
-	instance: Instance;
-	runtime: SquadRuntime;
-}): Promise<void> {
-	const log = logger();
-	const { instance, runtime } = params;
-
-	await transitionInstance(instance.id, 'working');
-
-	const teamLead = runtime.members.get('team-lead');
-	if (!teamLead) throw new Error('No team lead for task execution');
-
-	for (const task of instance.tasks) {
-		if (task.status === 'done') continue;
-
-		log.info({ taskId: task.id, assignedTo: task.assignedTo }, 'Executing task');
-		task.status = 'in_progress';
-
-		const agent = runtime.members.get(task.assignedTo);
-		if (!agent) {
-			log.warn({ role: task.assignedTo }, 'No agent for assigned role, team lead will handle');
-			// Reassign to team lead for delegation decision
-			task.result = `No agent with role '${task.assignedTo}' available.`;
-			task.status = 'failed';
-			continue;
-		}
-
-		try {
-			// Agent executes the task
-			const workingDir = instance.worktree?.path ?? '';
-			const taskPrompt = buildTaskPrompt(task, workingDir, instance);
-
-			const result = await agent.send(taskPrompt);
-			task.result = result;
-
-			// Team lead reviews
-			const review = await teamLead.send(
-				`An agent (${task.assignedTo}) completed a task. Review their work:\n\nTask: ${task.description}\n\nAgent's report:\n${result.slice(0, 2000)}\n\nIs this satisfactory? Reply with:\n- "APPROVED" if the work meets requirements\n- "REDO: <feedback>" if it needs changes`,
-			);
-
-			if (review.toUpperCase().includes('APPROVED')) {
-				task.status = 'done';
-				log.info({ taskId: task.id }, 'Task approved');
-			} else if (review.toUpperCase().includes('REDO:')) {
-				// Give agent one more attempt with feedback
-				const feedback = review.replace(/^.*REDO:\s*/i, '');
-				const retry = await agent.send(
-					`Your work on "${task.description}" needs revision. Feedback from team lead:\n\n${feedback}\n\nPlease address this feedback and report your updated results.`,
-				);
-				task.result = retry;
-				task.status = 'done'; // Accept after one retry
-				log.info({ taskId: task.id }, 'Task completed after revision');
-			} else {
-				task.status = 'done';
-			}
-		} catch (err) {
-			log.error({ err, taskId: task.id }, 'Task execution failed');
-			task.status = 'failed';
-			task.result = `Error: ${err instanceof Error ? err.message : String(err)}`;
-		}
-	}
-
-	// Move to reviewing phase
-	await transitionInstance(instance.id, 'reviewing');
-
-	// Team lead does final review
-	const taskSummary = instance.tasks
-		.map((t) => `- [${t.status}] ${t.description} (${t.assignedTo})`)
-		.join('\n');
-
-	const finalReview = await teamLead.send(
-		`All tasks have been executed. Here's the summary:\n\n${taskSummary}\n\nProvide a final assessment. Should we proceed to create a PR, or are there critical issues? Reply with:\n- "READY_FOR_PR: <PR title>" if ready\n- "NEEDS_WORK: <what's missing>" if not ready`,
-	);
-
-	if (finalReview.toUpperCase().includes('READY_FOR_PR:')) {
-		instance.meetingLog.push(`[team-lead] Final review: ${finalReview}`);
-	} else {
-		// Mark complete anyway — we don't loop indefinitely
-		instance.meetingLog.push(`[team-lead] Final review (issues noted): ${finalReview}`);
-	}
-}
-
-function buildTaskPrompt(task: InstanceTask, workingDir: string, instance: Instance): string {
-	const parts = ['You have been assigned the following task:', `\nTask: ${task.description}`];
-
-	if (workingDir) {
-		parts.push(`\nWorking directory: ${workingDir}`);
-	}
-
-	if (instance.issueRef) {
-		parts.push(`\nRelated issue: ${instance.issueRef}`);
-	}
-
-	parts.push(
-		'\nComplete the task to the best of your ability. Use your available tools to read, edit, and test code as needed. Report back with a summary of what you did.',
-	);
-
-	return parts.join('');
-}

package/src/squad/execution/worktree.ts

@@ -1,138 +0,0 @@
-import { execSync } from 'node:child_process';
-import { existsSync, rmSync } from 'node:fs';
-import { join } from 'node:path';
-import { createChildLogger } from '../../logging/logger.js';
-
-const logger = () => createChildLogger('worktree');
-
-export interface WorktreeInfo {
-	path: string;
-	branch: string;
-}
-
-/**
- * Create a git worktree for an instance.
- * Branch naming: io/{squad-name}/{short-id}
- */
-export function createWorktree(params: {
-	repoPath: string;
-	squadName: string;
-	instanceId: string;
-}): WorktreeInfo {
-	const log = logger();
-	const shortId = params.instanceId.slice(0, 8);
-	const branch = `io/${params.squadName}/${shortId}`;
-	const worktreePath = join(
-		params.repoPath,
-		'..',
-		'.io-worktrees',
-		`${params.squadName}-${shortId}`,
-	);
-
-	// Ensure the repo is a git repository
-	if (!existsSync(join(params.repoPath, '.git'))) {
-		throw new Error(`Not a git repository: ${params.repoPath}`);
-	}
-
-	// Create the worktree with a new branch from HEAD
-	try {
-		execSync(`git worktree add -b "${branch}" "${worktreePath}"`, {
-			cwd: params.repoPath,
-			stdio: 'pipe',
-			encoding: 'utf-8',
-		});
-	} catch (err) {
-		// Branch might already exist — try without -b
-		try {
-			execSync(`git worktree add "${worktreePath}" "${branch}"`, {
-				cwd: params.repoPath,
-				stdio: 'pipe',
-				encoding: 'utf-8',
-			});
-		} catch (innerErr) {
-			throw new Error(
-				`Failed to create worktree: ${innerErr instanceof Error ? innerErr.message : String(innerErr)}`,
-			);
-		}
-	}
-
-	log.info({ worktreePath, branch }, 'Worktree created');
-	return { path: worktreePath, branch };
-}
-
-/**
- * Remove a git worktree and delete its branch.
- */
-export function removeWorktree(params: {
-	repoPath: string;
-	worktreePath: string;
-	branch: string;
-}): void {
-	const log = logger();
-
-	try {
-		execSync(`git worktree remove "${params.worktreePath}" --force`, {
-			cwd: params.repoPath,
-			stdio: 'pipe',
-			encoding: 'utf-8',
-		});
-	} catch {
-		// Worktree might already be removed; try cleaning up the directory
-		if (existsSync(params.worktreePath)) {
-			rmSync(params.worktreePath, { recursive: true, force: true });
-		}
-		// Prune worktree references
-		try {
-			execSync('git worktree prune', { cwd: params.repoPath, stdio: 'pipe' });
-		} catch {
-			// ignore
-		}
-	}
-
-	// Delete the branch
-	try {
-		execSync(`git branch -D "${params.branch}"`, {
-			cwd: params.repoPath,
-			stdio: 'pipe',
-			encoding: 'utf-8',
-		});
-	} catch {
-		// Branch might not exist or be checked out elsewhere
-	}
-
-	log.info({ branch: params.branch }, 'Worktree removed');
-}
-
-/**
- * List all IO-managed worktrees for a repository.
- */
-export function listWorktrees(repoPath: string): WorktreeInfo[] {
-	try {
-		const output = execSync('git worktree list --porcelain', {
-			cwd: repoPath,
-			stdio: 'pipe',
-			encoding: 'utf-8',
-		});
-
-		const worktrees: WorktreeInfo[] = [];
-		const blocks = output.split('\n\n');
-
-		for (const block of blocks) {
-			const lines = block.trim().split('\n');
-			const pathLine = lines.find((l) => l.startsWith('worktree '));
-			const branchLine = lines.find((l) => l.startsWith('branch '));
-
-			if (pathLine && branchLine) {
-				const path = pathLine.replace('worktree ', '');
-				const branch = branchLine.replace('branch refs/heads/', '');
-				if (branch.startsWith('io/')) {
-					worktrees.push({ path, branch });
-				}
-			}
-		}
-
-		return worktrees;
-	} catch {
-		return [];
-	}
-}

package/src/squad/hiring.ts

@@ -1,222 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { basename, join } from 'node:path';
-import { createChildLogger } from '../logging/logger.js';
-import { ensureSquadWiki } from '../wiki/index.js';
-import { addMember, createSquad } from './manager.js';
-import { generateSquadNames } from './name-generator.js';
-import { QA_TESTER_SKILL, SCRIBE_SKILL, TEAM_LEAD_SKILL } from './roles/templates.js';
-import { parseSkillContent } from './skill-parser.js';
-
-const logger = () => createChildLogger('hiring');
-
-interface ProjectAnalysis {
-	name: string;
-	languages: string[];
-	frameworks: string[];
-	hasTests: boolean;
-	hasCi: boolean;
-	suggestedSpecialists: string[];
-}
-
-/**
- * Analyze a project directory to determine what kind of squad it needs.
- */
-export function analyzeProject(projectPath: string): ProjectAnalysis {
-	const name = basename(projectPath);
-	const languages: string[] = [];
-	const frameworks: string[] = [];
-	let hasTests = false;
-	let hasCi = false;
-
-	// Check for common project indicators
-	const files = safeReadDir(projectPath);
-
-	// Language detection
-	if (files.includes('package.json')) {
-		languages.push('TypeScript/JavaScript');
-		const pkg = safeReadJson(join(projectPath, 'package.json'));
-		if (pkg) {
-			const deps = (pkg.dependencies ?? {}) as Record<string, string>;
-			const devDeps = (pkg.devDependencies ?? {}) as Record<string, string>;
-			const allDeps = { ...deps, ...devDeps };
-			if (allDeps.react || allDeps['react-dom']) frameworks.push('React');
-			if (allDeps.vue) frameworks.push('Vue');
-			if (allDeps.svelte) frameworks.push('Svelte');
-			if (allDeps.next) frameworks.push('Next.js');
-			if (allDeps.express || allDeps.fastify || allDeps.koa) frameworks.push('Node.js Backend');
-			if (allDeps.vitest || allDeps.jest || allDeps.mocha) hasTests = true;
-		}
-	}
-	if (files.includes('Cargo.toml')) languages.push('Rust');
-	if (files.includes('go.mod')) languages.push('Go');
-	if (files.includes('requirements.txt') || files.includes('pyproject.toml'))
-		languages.push('Python');
-	if (files.includes('Gemfile')) languages.push('Ruby');
-	if (files.some((f) => f.endsWith('.csproj') || f.endsWith('.sln'))) languages.push('C#/.NET');
-
-	// CI detection
-	if (files.includes('.github')) {
-		const ghDir = safeReadDir(join(projectPath, '.github'));
-		if (ghDir.includes('workflows')) hasCi = true;
-	}
-
-	// Suggest specialists based on detected tech
-	const suggestedSpecialists: string[] = [];
-	if (frameworks.includes('React') || frameworks.includes('Vue') || frameworks.includes('Svelte'))
-		suggestedSpecialists.push('frontend-developer');
-	if (frameworks.includes('Node.js Backend')) suggestedSpecialists.push('backend-developer');
-	if (languages.includes('Rust')) suggestedSpecialists.push('rust-developer');
-	if (languages.includes('Go')) suggestedSpecialists.push('go-developer');
-	if (languages.includes('Python')) suggestedSpecialists.push('python-developer');
-	if (languages.includes('C#/.NET')) suggestedSpecialists.push('dotnet-developer');
-
-	// If no specialists detected, add a generic one
-	if (suggestedSpecialists.length === 0 && languages.length > 0) {
-		suggestedSpecialists.push('developer');
-	}
-
-	return { name, languages, frameworks, hasTests, hasCi, suggestedSpecialists };
-}
-
-/**
- * Generate a specialist SKILL.md from a role name and detected context.
- */
-function generateSpecialistSkill(role: string, analysis: ProjectAnalysis): string {
-	const langContext = analysis.languages.join(', ');
-	const frameworkContext =
-		analysis.frameworks.length > 0 ? `\nFrameworks: ${analysis.frameworks.join(', ')}` : '';
-
-	return `---
-role: ${role}
-tools:
-  - read_file
-  - edit_file
-  - run_command
-  - search_code
-veto: false
----
-
-# ${titleCase(role)}
-
-## Identity
-You are a ${titleCase(role)} specializing in ${langContext}.${frameworkContext}
-
-## Responsibilities
-- Implement features and fix bugs assigned by the Team Lead
-- Write clean, well-tested code following project conventions
-- Run tests before submitting work for review
-- Respond to code review feedback promptly
-
-## Boundaries
-- Only work on tasks assigned to you by the Team Lead
-- Do NOT modify files outside your area of expertise unless directed
-- Do NOT merge PRs — submit work for team lead review
-- Always run the test suite before reporting task completion
-
-## Project Context
-Languages: ${langContext}${frameworkContext}
-`;
-}
-
-/**
- * Execute the full squad hiring flow:
- * 1. Analyze the project
- * 2. Create the squad in DB
- * 3. Write SKILL.md files to disk
- * 4. Add all members
- */
-export async function hireSquad(params: {
-	projectPath: string;
-	repoUrl?: string;
-	name?: string;
-	universe?: string;
-}): Promise<{ squadId: string; analysis: ProjectAnalysis; members: string[]; universe: string }> {
-	const log = logger();
-
-	// 1. Analyze
-	const analysis = analyzeProject(params.projectPath);
-	const squadName = params.name ?? analysis.name;
-	log.info({ squadName, analysis }, 'Project analyzed');
-
-	// 2. Build skill files
-	const skillsDir = join(homedir(), '.io', 'squads', squadName);
-	mkdirSync(skillsDir, { recursive: true });
-
-	const skillFiles: { role: string; content: string; veto: boolean }[] = [
-		{ role: 'team-lead', content: TEAM_LEAD_SKILL, veto: true },
-		{ role: 'scribe', content: SCRIBE_SKILL, veto: false },
-		{ role: 'qa-tester', content: QA_TESTER_SKILL, veto: true },
-	];
-
-	for (const specialist of analysis.suggestedSpecialists) {
-		skillFiles.push({
-			role: specialist,
-			content: generateSpecialistSkill(specialist, analysis),
-			veto: false,
-		});
-	}
-
-	// 3. Generate character names from universe via LLM
-	const allRoles = skillFiles.map((f) => f.role);
-	const generated = await generateSquadNames(allRoles, params.universe);
-	log.info({ squadName, universe: generated.universe }, 'Universe names generated');
-
-	// 4. Create squad
-	const squad = await createSquad({
-		name: squadName,
-		projectPath: params.projectPath,
-		repoUrl: params.repoUrl,
-		universe: generated.universe,
-	});
-
-	// 5. Create wiki folder for this squad
-	ensureSquadWiki(squadName);
-
-	// 6. Write files and add members
-	const memberRoles: string[] = [];
-	for (const { role, content, veto } of skillFiles) {
-		const filePath = join(skillsDir, `${role}.skill.md`);
-		writeFileSync(filePath, content, 'utf-8');
-
-		const skill = parseSkillContent(content, filePath);
-		const assignment = generated.assignments.find((a) => a.role === role);
-		const displayName = assignment?.displayName ?? role;
-		const persona = assignment?.persona;
-		await addMember({ squadId: squad.id, skill, displayName, persona, isVetoMember: veto });
-		memberRoles.push(`${displayName} (${role})`);
-	}
-
-	log.info(
-		{ squadId: squad.id, members: memberRoles, universe: generated.universe },
-		'Squad hired successfully',
-	);
-	return { squadId: squad.id, analysis, members: memberRoles, universe: generated.universe };
-}
-
-// Helpers
-
-function safeReadDir(dir: string): string[] {
-	try {
-		if (!existsSync(dir)) return [];
-		return readdirSync(dir);
-	} catch {
-		return [];
-	}
-}
-
-function safeReadJson(path: string): Record<string, unknown> | null {
-	try {
-		if (!existsSync(path)) return null;
-		return JSON.parse(readFileSync(path, 'utf-8'));
-	} catch {
-		return null;
-	}
-}
-
-function titleCase(str: string): string {
-	return str
-		.split('-')
-		.map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-		.join(' ');
-}

package/src/squad/index.ts

@@ -1,17 +0,0 @@
-export { EventBus, getEventBus } from './event-bus.js';
-export { parseSkillFile, parseSkillContent, compileSystemPrompt } from './skill-parser.js';
-export type { SkillDefinition } from './skill-parser.js';
-export { Agent } from './agent.js';
-export type { AgentConfig } from './agent.js';
-export {
-	createSquad,
-	addMember,
-	listSquads,
-	getSquadByName,
-	getSquadMembers,
-	disbandSquad,
-	bootSquad,
-	getSquadRuntime,
-	delegateToSquad,
-} from './manager.js';
-export { hireSquad, analyzeProject } from './hiring.js';