Agents & Dev TeamsCopy Anchor Link

import {
  DeveloperAgent,
  DevTeam,
  createDeveloper,
  createDevTeam,
  DEVELOPER_PROFILES,
} from "@codmir/ai";

import { createDevTeam, DEVELOPER_PROFILES } from "@codmir/ai";

const team = createDevTeam({
  name: "Core Team",
  projectContext: {
    projectId: "codmir",
    name: "Codmir",
    techStack: ["TypeScript", "Next.js", "NestJS", "Prisma"],
  },
  developers: [
    DEVELOPER_PROFILES.alex,   // fullstack lead
    DEVELOPER_PROFILES.sam,    // frontend specialist
    DEVELOPER_PROFILES.jordan, // backend specialist
    DEVELOPER_PROFILES.riley,  // testing specialist
  ],
  autoAssign: true,
  requirePeerReview: true,
});

// Queue a ticket
team.queueTicket({
  id: "TICKET-42",
  title: "Fix login form validation",
  description: "Email field accepts invalid formats",
  type: "bug",
  priority: "high",
  status: "open",
  relatedFiles: ["src/components/LoginForm.tsx"],
  acceptanceCriteria: ["Email validation uses RFC 5322 regex"],
  createdAt: new Date(),
  updatedAt: new Date(),
});

// Auto-assign picks the best available developer
const breakdown = await team.tryAssignNextTicket();
// breakdown.plan => [{ order: 1, description: "Analyze requirements...", type: "analyze" }, ...]

import { createDeveloper, DEVELOPER_PROFILES } from "@codmir/ai";

// From built-in profile
const alex = createDeveloper("alex", projectContext);

// From custom profile
const custom = createDeveloper(
  {
    id: "aria",
    name: "Aria",
    specialization: "frontend",
    skills: ["React", "CSS", "Accessibility", "Design Systems"],
    experience: "senior",
    personality: "Design-focused, accessibility advocate",
  },
  projectContext,
);

interface DeveloperAgentConfig {
  profile: DeveloperProfile;
  projectContext: ProjectContext;
  maxConcurrentTasks?: number;
  autoCommit?: boolean;
  requireReview?: boolean;
}

const breakdown = await developer.assignTicket(ticket);
console.log(breakdown.plan);
// [
//   { order: 1, description: "Analyze requirements and existing code", type: "analyze" },
//   { order: 2, description: "Implement the solution", type: "implement" },
//   { order: 3, description: "Write tests", type: "test" },
//   { order: 4, description: "Self-review and refactor", type: "review" },
// ]

await developer.work();

const result = await developer.review(codeString, "Checkout flow refactor");
// {
//   approved: true,
//   comments: [{ file: "checkout.tsx", line: 42, message: "Missing null check", severity: "error" }],
//   suggestions: ["Consider extracting validation logic into a hook"],
// }

const status = developer.getStatus();
// {
//   id: "abc123",
//   profile: { name: "Alex", specialization: "fullstack", ... },
//   status: "coding",       // "idle" | "analyzing" | "coding" | "testing" | "reviewing" | "blocked"
//   currentTicket: { ... },
//   workLog: [...],
//   metrics: { ticketsCompleted: 5, linesWritten: 1200, ... },
// }

interface DeveloperMetrics {
  tasksCompleted: number;
  tokensUsed: number;
  averageResponseTime: number;
  successRate: number;
  ticketsCompleted: number;
  linesWritten: number;
  testsWritten: number;
  bugsFixed: number;
  reviewsCompleted: number;
}

const team = createDevTeam({
  name: "Platform Team",
  projectContext: { ... },
  developers: [DEVELOPER_PROFILES.alex, DEVELOPER_PROFILES.riley],
  maxSize: 6,
  requirePeerReview: true,
  autoAssign: true,
});

interface DevTeamConfig {
  name: string;
  projectContext: ProjectContext;
  developers?: DeveloperProfile[];   // defaults to [alex, riley]
  maxSize?: number;
  requirePeerReview?: boolean;
  autoAssign?: boolean;
}

const dev = team.addDeveloper(DEVELOPER_PROFILES.morgan);

team.removeDeveloper(dev.id);

const frontendDevs = team.findBySpecialization("frontend");

const breakdown = await team.assignTicket("TICKET-42", developer.id);

const reviews = await team.requestReview(code, developer.id, "Auth refactor");
// [{ reviewerId: "...", reviewerName: "Riley", approved: true, comments: [...] }]

const report = team.standup();
// {
//   timestamp: Date,
//   teamName: "Core Team",
//   members: [{ id, name, status, currentTicket, metrics }],
//   queueSize: 3,
//   activeTickets: 2,
//   completedToday: 1,
// }

interface TeamMetrics {
  totalTicketsCompleted: number;
  averageTicketTime: number;
  teamVelocity: number;
  codeQualityScore: number;
}

import { DEVELOPER_PROFILES } from "@codmir/ai";

const alex = DEVELOPER_PROFILES.alex;
// { id: "alex", name: "Alex", specialization: "fullstack", skills: [...], experience: "senior" }

type DeveloperSpecialization =
  | "fullstack"
  | "frontend"
  | "backend"
  | "devops"
  | "security"
  | "performance"
  | "testing"
  | "documentation";

interface DeveloperProfile {
  id: string;
  name: string;
  specialization: DeveloperSpecialization;
  skills: string[];
  experience: string;
  personality?: string;
}

interface Ticket {
  id: string;
  title: string;
  description: string;
  type: "feature" | "bug" | "refactor" | "docs" | "test" | "chore";
  priority: TicketPriority;      // "critical" | "high" | "medium" | "low"
  status: TicketStatus;          // "open" | "in_progress" | "review" | "done" | "blocked"
  relatedFiles?: string[];
  acceptanceCriteria?: string[];
  labels?: string[];
  estimate?: number;
  assignee?: string;
  parentId?: string;
  subtasks?: string[];
  source?: string;
  externalId?: string;
  createdAt: Date;
  updatedAt: Date;
}

interface TaskBreakdown {
  ticket: Ticket;
  plan: TaskStep[];
  estimatedDuration: number;
  risks?: string[];
  dependencies?: string[];
}

interface TaskStep {
  order: number;
  description: string;
  type: "analyze" | "implement" | "test" | "review" | "document";
  files?: string[];
  completed: boolean;
  output?: string;
}