@nairon-ai/aegis 0.2.0

package/src/sources/github.ts

@@ -0,0 +1,57 @@
+import { GitHubClient } from "../integrations/github.js";
+import type { AegisConfig, WorkItem } from "../shared/types.js";
+import type { ClaimOptions, IssueSource } from "./types.js";
+
+export class GitHubIssueSource implements IssueSource {
+	readonly name = "github" as const;
+	private readonly config: AegisConfig;
+	private readonly github: GitHubClient;
+
+	constructor(config: AegisConfig) {
+		this.config = config;
+		this.github = new GitHubClient(config);
+	}
+
+	listReadyBugs(): Promise<WorkItem[]> {
+		return this.github.listReadyIssues();
+	}
+
+	async claim(item: WorkItem, options: ClaimOptions): Promise<void> {
+		const number = requireIssueNumber(item);
+		await this.github.addLabels(item.repo, number, [this.config.inProgressLabel]);
+		await this.github.comment(
+			item.repo,
+			number,
+			`Aegis claimed this bug.\n\nRun: \`${options.runId}\`\nBranch: \`${options.branchName}\``,
+		);
+	}
+
+	async postNeedsInfo(item: WorkItem, question: string): Promise<void> {
+		const number = requireIssueNumber(item);
+		await this.github.addLabels(item.repo, number, [this.config.needsInfoLabel]);
+		await this.github.comment(item.repo, number, question);
+	}
+
+	async postPlan(item: WorkItem, body: string): Promise<void> {
+		await this.github.comment(item.repo, requireIssueNumber(item), body);
+	}
+
+	async linkPullRequest(item: WorkItem, prUrl: string): Promise<void> {
+		const number = requireIssueNumber(item);
+		await this.github.addLabels(item.repo, number, [this.config.prOpenedLabel]);
+		await this.github.removeLabel(item.repo, number, this.config.inProgressLabel);
+		await this.github.comment(item.repo, number, `Aegis opened a PR: ${prUrl}`);
+	}
+
+	async markBlocked(item: WorkItem, body: string): Promise<void> {
+		const number = requireIssueNumber(item);
+		await this.github.addLabels(item.repo, number, [this.config.blockedLabel]);
+		await this.github.removeLabel(item.repo, number, this.config.inProgressLabel);
+		await this.github.comment(item.repo, number, body);
+	}
+}
+
+function requireIssueNumber(item: WorkItem): number {
+	if (!item.number) throw new Error(`GitHub issue number missing for ${item.identifier}`);
+	return item.number;
+}

package/src/sources/index.ts

@@ -0,0 +1,20 @@
+import type { AegisConfig, WorkSource } from "../shared/types.js";
+import { GitHubIssueSource } from "./github.js";
+import { LinearIssueSource } from "./linear.js";
+import type { IssueSource } from "./types.js";
+
+export function createSources(config: AegisConfig): IssueSource[] {
+	const sources: IssueSource[] = [new GitHubIssueSource(config)];
+	if (config.linear?.apiKey && config.linear.teamId) {
+		sources.push(new LinearIssueSource(config));
+	}
+	return sources;
+}
+
+export function sourceFor(config: AegisConfig, source: WorkSource): IssueSource {
+	const match = createSources(config).find((candidate) => candidate.name === source);
+	if (!match) throw new Error(`${source} source is not configured`);
+	return match;
+}
+
+export type { IssueSource } from "./types.js";

package/src/sources/linear.ts

@@ -0,0 +1,44 @@
+import { LinearClient } from "../integrations/linear.js";
+import type { AegisConfig, WorkItem } from "../shared/types.js";
+import type { ClaimOptions, IssueSource } from "./types.js";
+
+export class LinearIssueSource implements IssueSource {
+	readonly name = "linear" as const;
+	private readonly config: AegisConfig;
+	private readonly linear: LinearClient;
+
+	constructor(config: AegisConfig) {
+		this.config = config;
+		this.linear = new LinearClient(config);
+	}
+
+	listReadyBugs(): Promise<WorkItem[]> {
+		return this.linear.listReadyIssues();
+	}
+
+	async claim(item: WorkItem, options: ClaimOptions): Promise<void> {
+		await this.linear.moveToStatus(item.id, this.config.linear?.inProgressStatusName);
+		await this.linear.comment(
+			item.id,
+			`Aegis claimed this bug.\n\nRun: \`${options.runId}\`\nBranch: \`${options.branchName}\``,
+		);
+	}
+
+	async postNeedsInfo(item: WorkItem, question: string): Promise<void> {
+		await this.linear.moveToStatus(item.id, this.config.linear?.needsInfoStatusName);
+		await this.linear.comment(item.id, question);
+	}
+
+	async postPlan(item: WorkItem, body: string): Promise<void> {
+		await this.linear.comment(item.id, body);
+	}
+
+	async linkPullRequest(item: WorkItem, prUrl: string): Promise<void> {
+		await this.linear.linkPullRequest(item.id, prUrl);
+	}
+
+	async markBlocked(item: WorkItem, body: string): Promise<void> {
+		await this.linear.moveToStatus(item.id, this.config.linear?.blockedStatusName);
+		await this.linear.comment(item.id, body);
+	}
+}

package/src/sources/types.ts

@@ -0,0 +1,16 @@
+import type { WorkItem } from "../shared/types.js";
+
+export type ClaimOptions = {
+	runId: string;
+	branchName: string;
+};
+
+export interface IssueSource {
+	name: "github" | "linear";
+	listReadyBugs(): Promise<WorkItem[]>;
+	claim(item: WorkItem, options: ClaimOptions): Promise<void>;
+	postNeedsInfo(item: WorkItem, question: string): Promise<void>;
+	postPlan(item: WorkItem, body: string): Promise<void>;
+	linkPullRequest(item: WorkItem, prUrl: string): Promise<void>;
+	markBlocked(item: WorkItem, body: string): Promise<void>;
+}

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"lib": ["ESNext"],
+		"types": ["@cloudflare/workers-types/2023-07-01", "bun-types"],
+		"jsx": "react-jsx",
+		"jsxImportSource": "hono/jsx",
+		"strict": true,
+		"skipLibCheck": true,
+		"noEmit": true,
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"resolveJsonModule": true,
+		"isolatedModules": true,
+		"verbatimModuleSyntax": true,
+		"paths": {
+			"@/*": ["./src/*"]
+		},
+		"baseUrl": "."
+	},
+	"include": ["src/**/*.ts", ".flue/**/*.ts"],
+	"exclude": ["node_modules", "dist"]
+}

package/tsconfig.node.json

@@ -0,0 +1,16 @@
+{
+	"extends": "./tsconfig.json",
+	"compilerOptions": {
+		"module": "NodeNext",
+		"moduleResolution": "NodeNext",
+		"rootDir": "src",
+		"outDir": "dist-node",
+		"noEmit": false,
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": true,
+		"types": ["node", "@cloudflare/workers-types/2023-07-01"]
+	},
+	"include": ["src/**/*.ts"],
+	"exclude": ["node_modules", "dist", "dist-node"]
+}

package/wrangler.jsonc

@@ -0,0 +1,43 @@
+{
+	"$schema": "node_modules/wrangler/config-schema.json",
+	"name": "aegis-worker",
+	"main": "dist/_entry.ts",
+	"compatibility_date": "2026-05-01",
+	"compatibility_flags": ["nodejs_compat"],
+	"triggers": {
+		"crons": ["*/10 * * * *"]
+	},
+	"durable_objects": {
+		"bindings": [
+			{
+				"name": "Sandbox",
+				"class_name": "Sandbox"
+			}
+		]
+	},
+	"migrations": [
+		{
+			"tag": "v1",
+			"new_sqlite_classes": ["Sandbox"]
+		}
+	],
+	"containers": [
+		{
+			"class_name": "Sandbox",
+			"image": "./Dockerfile"
+		}
+	],
+	"vars": {
+		"BASE_BRANCH": "main",
+		"AUTOMATION_MODE": "plan-first",
+		"CONTEXT_PROFILE": "minimal",
+		"MAX_CONCURRENT_RUNS": "1",
+		"READY_LABEL": "ready to implement",
+		"BUG_LABEL": "bug",
+		"IN_PROGRESS_LABEL": "aegis:in-progress",
+		"NEEDS_INFO_LABEL": "aegis:needs-info",
+		"BLOCKED_LABEL": "aegis:blocked",
+		"PR_OPENED_LABEL": "aegis:pr-opened",
+		"AGENT_MODEL": "openai/gpt-5.1"
+	}
+}