beercan 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+declare const ConfigSchema: z.ZodObject<{
+    anthropicApiKey: z.ZodString;
+    dataDir: z.ZodDefault<z.ZodString>;
+    defaultModel: z.ZodDefault<z.ZodString>;
+    heavyModel: z.ZodDefault<z.ZodString>;
+    gatekeeperModel: z.ZodDefault<z.ZodString>;
+    maxBloopIterations: z.ZodDefault<z.ZodNumber>;
+    bloopTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxConcurrent: z.ZodDefault<z.ZodNumber>;
+    defaultTokenBudget: z.ZodDefault<z.ZodNumber>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    logFile: z.ZodOptional<z.ZodString>;
+    webhookRateLimit: z.ZodDefault<z.ZodNumber>;
+    webhookMaxBodySize: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    anthropicApiKey: string;
+    dataDir: string;
+    defaultModel: string;
+    heavyModel: string;
+    gatekeeperModel: string;
+    maxBloopIterations: number;
+    bloopTimeoutMs: number;
+    maxConcurrent: number;
+    defaultTokenBudget: number;
+    logLevel: "debug" | "info" | "warn" | "error";
+    webhookRateLimit: number;
+    webhookMaxBodySize: number;
+    logFile?: string | undefined;
+}, {
+    anthropicApiKey: string;
+    dataDir?: string | undefined;
+    defaultModel?: string | undefined;
+    heavyModel?: string | undefined;
+    gatekeeperModel?: string | undefined;
+    maxBloopIterations?: number | undefined;
+    bloopTimeoutMs?: number | undefined;
+    maxConcurrent?: number | undefined;
+    defaultTokenBudget?: number | undefined;
+    logLevel?: "debug" | "info" | "warn" | "error" | undefined;
+    logFile?: string | undefined;
+    webhookRateLimit?: number | undefined;
+    webhookMaxBodySize?: number | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare function getConfig(): Config;
+export declare function getProjectDir(projectSlug: string): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAchB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD,wBAAgB,SAAS,IAAI,MAAM,CA+BlC;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/config.js

@@ -0,0 +1,61 @@
+import { config as loadEnv } from "dotenv";
+import { z } from "zod";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+// Resolve .env relative to project root (one level up from src/ or dist/)
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.resolve(__dirname, "..");
+loadEnv({ path: path.join(projectRoot, ".env"), override: true });
+const ConfigSchema = z.object({
+    anthropicApiKey: z.string().min(1),
+    dataDir: z.string().default(path.join(os.homedir(), ".beercan")),
+    defaultModel: z.string().default("claude-sonnet-4-6"),
+    heavyModel: z.string().default("claude-opus-4-6"),
+    gatekeeperModel: z.string().default("claude-haiku-4-5-20251001"),
+    maxBloopIterations: z.number().default(50),
+    bloopTimeoutMs: z.number().default(600_000),
+    maxConcurrent: z.number().default(2),
+    defaultTokenBudget: z.number().default(100_000),
+    logLevel: z.enum(["debug", "info", "warn", "error"]).default("info"),
+    logFile: z.string().optional(),
+    webhookRateLimit: z.number().default(60),
+    webhookMaxBodySize: z.number().default(1_048_576),
+});
+let _config = null;
+export function getConfig() {
+    if (!_config) {
+        _config = ConfigSchema.parse({
+            anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+            dataDir: process.env.BEERCAN_DATA_DIR,
+            defaultModel: process.env.BEERCAN_DEFAULT_MODEL,
+            heavyModel: process.env.BEERCAN_HEAVY_MODEL,
+            gatekeeperModel: process.env.BEERCAN_GATEKEEPER_MODEL,
+            maxBloopIterations: process.env.BEERCAN_MAX_ITERATIONS
+                ? parseInt(process.env.BEERCAN_MAX_ITERATIONS)
+                : undefined,
+            bloopTimeoutMs: process.env.BEERCAN_BLOOP_TIMEOUT_MS
+                ? parseInt(process.env.BEERCAN_BLOOP_TIMEOUT_MS)
+                : undefined,
+            maxConcurrent: process.env.BEERCAN_MAX_CONCURRENT
+                ? parseInt(process.env.BEERCAN_MAX_CONCURRENT)
+                : undefined,
+            defaultTokenBudget: process.env.BEERCAN_TOKEN_BUDGET
+                ? parseInt(process.env.BEERCAN_TOKEN_BUDGET)
+                : undefined,
+            logLevel: process.env.BEERCAN_LOG_LEVEL,
+            logFile: process.env.BEERCAN_LOG_FILE,
+            webhookRateLimit: process.env.BEERCAN_WEBHOOK_RATE_LIMIT
+                ? parseInt(process.env.BEERCAN_WEBHOOK_RATE_LIMIT)
+                : undefined,
+            webhookMaxBodySize: process.env.BEERCAN_WEBHOOK_MAX_BODY_SIZE
+                ? parseInt(process.env.BEERCAN_WEBHOOK_MAX_BODY_SIZE)
+                : undefined,
+        });
+    }
+    return _config;
+}
+export function getProjectDir(projectSlug) {
+    return path.join(getConfig().dataDir, "projects", projectSlug);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/core/gatekeeper.d.ts

@@ -0,0 +1,163 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { z } from "zod";
+import type { Project } from "../schemas.js";
+import type { AgentRole, BloopTeam } from "./roles.js";
+import type { MemoryManager } from "../memory/index.js";
+export declare const GatekeeperRolePlanSchema: z.ZodObject<{
+    roleId: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    allowedTools: z.ZodArray<z.ZodString, "many">;
+    phase: z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>;
+    model: z.ZodOptional<z.ZodString>;
+    maxIterations: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    maxIterations: number;
+    name: string;
+    description: string;
+    allowedTools: string[];
+    phase: "plan" | "primary" | "review" | "validate" | "summarize";
+    roleId: string;
+    systemPrompt?: string | undefined;
+    model?: string | undefined;
+}, {
+    maxIterations: number;
+    name: string;
+    description: string;
+    allowedTools: string[];
+    phase: "plan" | "primary" | "review" | "validate" | "summarize";
+    roleId: string;
+    systemPrompt?: string | undefined;
+    model?: string | undefined;
+}>;
+export type GatekeeperRolePlan = z.infer<typeof GatekeeperRolePlanSchema>;
+export declare const GatekeeperPipelineStagePlanSchema: z.ZodObject<{
+    phase: z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>;
+    roleId: z.ZodString;
+    canReject: z.ZodOptional<z.ZodBoolean>;
+    rejectTo: z.ZodOptional<z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>>;
+}, "strip", z.ZodTypeAny, {
+    phase: "plan" | "primary" | "review" | "validate" | "summarize";
+    roleId: string;
+    canReject?: boolean | undefined;
+    rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+}, {
+    phase: "plan" | "primary" | "review" | "validate" | "summarize";
+    roleId: string;
+    canReject?: boolean | undefined;
+    rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+}>;
+export declare const GatekeeperPlanSchema: z.ZodObject<{
+    reasoning: z.ZodString;
+    complexity: z.ZodEnum<["simple", "medium", "complex"]>;
+    roles: z.ZodArray<z.ZodObject<{
+        roleId: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        systemPrompt: z.ZodOptional<z.ZodString>;
+        allowedTools: z.ZodArray<z.ZodString, "many">;
+        phase: z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>;
+        model: z.ZodOptional<z.ZodString>;
+        maxIterations: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        maxIterations: number;
+        name: string;
+        description: string;
+        allowedTools: string[];
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        systemPrompt?: string | undefined;
+        model?: string | undefined;
+    }, {
+        maxIterations: number;
+        name: string;
+        description: string;
+        allowedTools: string[];
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        systemPrompt?: string | undefined;
+        model?: string | undefined;
+    }>, "many">;
+    pipeline: z.ZodArray<z.ZodObject<{
+        phase: z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>;
+        roleId: z.ZodString;
+        canReject: z.ZodOptional<z.ZodBoolean>;
+        rejectTo: z.ZodOptional<z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>>;
+    }, "strip", z.ZodTypeAny, {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }, {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }>, "many">;
+    maxCycles: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    pipeline: {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }[];
+    maxCycles: number;
+    reasoning: string;
+    complexity: "simple" | "medium" | "complex";
+    roles: {
+        maxIterations: number;
+        name: string;
+        description: string;
+        allowedTools: string[];
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        systemPrompt?: string | undefined;
+        model?: string | undefined;
+    }[];
+}, {
+    pipeline: {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }[];
+    maxCycles: number;
+    reasoning: string;
+    complexity: "simple" | "medium" | "complex";
+    roles: {
+        maxIterations: number;
+        name: string;
+        description: string;
+        allowedTools: string[];
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        systemPrompt?: string | undefined;
+        model?: string | undefined;
+    }[];
+}>;
+export type GatekeeperPlan = z.infer<typeof GatekeeperPlanSchema>;
+export interface GatekeeperResult {
+    team: BloopTeam;
+    dynamicRoles: AgentRole[];
+    plan: GatekeeperPlan;
+    tokensUsed: number;
+}
+export declare class Gatekeeper {
+    private client;
+    private memory;
+    constructor(client: Anthropic, memory?: MemoryManager);
+    /** Analyze a goal and produce a dynamic team composition via a single LLM call. */
+    analyze(options: {
+        goal: string;
+        project: Project;
+        memoryContext?: string;
+        model?: string;
+    }): Promise<GatekeeperResult>;
+    /** Convert a GatekeeperPlan into BloopTeam + AgentRole[] */
+    private planToExecution;
+    /** Build the gatekeeper system prompt. */
+    private buildPrompt;
+}
+//# sourceMappingURL=gatekeeper.d.ts.map

package/dist/core/gatekeeper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatekeeper.d.ts","sourceRoot":"","sources":["../../src/core/gatekeeper.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;EAK5C,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAiFD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,aAAa;IAKrD,mFAAmF;IAC7E,OAAO,CAAC,OAAO,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2C7B,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IA+DvB,0CAA0C;IAC1C,OAAO,CAAC,WAAW;CAmDpB"}

package/dist/core/gatekeeper.js

@@ -0,0 +1,247 @@
+import { z } from "zod";
+import { getConfig } from "../config.js";
+import { BUILTIN_ROLES } from "./roles.js";
+import { ROLE_TEMPLATES } from "./role-templates.js";
+// ── Gatekeeper Plan Schema ──────────────────────────────────
+export const GatekeeperRolePlanSchema = z.object({
+    roleId: z.string(),
+    name: z.string(),
+    description: z.string(),
+    systemPrompt: z.string().optional(),
+    allowedTools: z.array(z.string()),
+    phase: z.enum(["plan", "primary", "review", "validate", "summarize"]),
+    model: z.string().optional(),
+    maxIterations: z.number(),
+});
+export const GatekeeperPipelineStagePlanSchema = z.object({
+    phase: z.enum(["plan", "primary", "review", "validate", "summarize"]),
+    roleId: z.string(),
+    canReject: z.boolean().optional(),
+    rejectTo: z.enum(["plan", "primary", "review", "validate", "summarize"]).optional(),
+});
+export const GatekeeperPlanSchema = z.object({
+    reasoning: z.string(),
+    complexity: z.enum(["simple", "medium", "complex"]),
+    roles: z.array(GatekeeperRolePlanSchema),
+    pipeline: z.array(GatekeeperPipelineStagePlanSchema),
+    maxCycles: z.number(),
+});
+// ── Structured Output Tool ──────────────────────────────────
+const EXECUTION_PLAN_TOOL = {
+    name: "create_execution_plan",
+    description: "Create a structured execution plan for the given goal. You MUST call this tool with your plan.",
+    input_schema: {
+        type: "object",
+        properties: {
+            reasoning: {
+                type: "string",
+                description: "Brief explanation of why you chose this team composition (2-3 sentences max)",
+            },
+            complexity: {
+                type: "string",
+                enum: ["simple", "medium", "complex"],
+                description: "Overall task complexity.",
+            },
+            roles: {
+                type: "array",
+                description: "The roles needed for this execution.",
+                items: {
+                    type: "object",
+                    properties: {
+                        roleId: {
+                            type: "string",
+                            description: "Role ID. Built-in: manager, coder, reviewer, tester, solo. Templates: writer, researcher, analyst, data_processor, summarizer, planner, editor, devops, architect. Or invent a new one.",
+                        },
+                        name: { type: "string", description: "Human-readable role name" },
+                        description: { type: "string", description: "What this role does for THIS specific goal" },
+                        systemPrompt: {
+                            type: "string",
+                            description: "Custom system prompt. REQUIRED for invented roles. Optional for built-in/template roles.",
+                        },
+                        allowedTools: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "Tools: read_file, write_file, list_directory, exec_command, memory_search, memory_store, memory_update, memory_link, memory_query_graph, memory_scratch. Use [\"*\"] for all.",
+                        },
+                        phase: {
+                            type: "string",
+                            enum: ["plan", "primary", "review", "validate", "summarize"],
+                        },
+                        model: {
+                            type: "string",
+                            description: "Optional model override. Options: claude-haiku-4-5-20251001 (fast/cheap), claude-sonnet-4-6 (balanced), claude-opus-4-6 (powerful).",
+                        },
+                        maxIterations: {
+                            type: "number",
+                            description: "Max API call iterations (typically 5-30).",
+                        },
+                    },
+                    required: ["roleId", "name", "description", "allowedTools", "phase", "maxIterations"],
+                },
+            },
+            pipeline: {
+                type: "array",
+                description: "Ordered pipeline stages.",
+                items: {
+                    type: "object",
+                    properties: {
+                        phase: { type: "string", enum: ["plan", "primary", "review", "validate", "summarize"] },
+                        roleId: { type: "string" },
+                        canReject: { type: "boolean", description: "Can this stage send work back?" },
+                        rejectTo: { type: "string", enum: ["plan", "primary", "review", "validate", "summarize"] },
+                    },
+                    required: ["phase", "roleId"],
+                },
+            },
+            maxCycles: {
+                type: "number",
+                description: "Max pipeline cycles (1 for simple, 2-3 for complex with review)",
+            },
+        },
+        required: ["reasoning", "complexity", "roles", "pipeline", "maxCycles"],
+    },
+};
+// ── Gatekeeper Class ────────────────────────────────────────
+export class Gatekeeper {
+    client;
+    memory;
+    constructor(client, memory) {
+        this.client = client;
+        this.memory = memory ?? null;
+    }
+    /** Analyze a goal and produce a dynamic team composition via a single LLM call. */
+    async analyze(options) {
+        const config = getConfig();
+        const model = options.model ?? config.gatekeeperModel;
+        const systemPrompt = this.buildPrompt(options);
+        const response = await this.client.messages.create({
+            model,
+            max_tokens: 2048,
+            system: systemPrompt,
+            tools: [EXECUTION_PLAN_TOOL],
+            tool_choice: { type: "tool", name: "create_execution_plan" },
+            messages: [
+                {
+                    role: "user",
+                    content: `Analyze this goal and create an execution plan:\n\n${options.goal}`,
+                },
+            ],
+        });
+        const tokensUsed = (response.usage?.input_tokens ?? 0) + (response.usage?.output_tokens ?? 0);
+        const toolBlock = response.content.find((b) => b.type === "tool_use" && b.name === "create_execution_plan");
+        if (!toolBlock) {
+            throw new Error("Gatekeeper did not produce a valid execution plan");
+        }
+        const plan = GatekeeperPlanSchema.parse(toolBlock.input);
+        // Validate: every pipeline roleId must exist in roles array
+        const roleIds = new Set(plan.roles.map((r) => r.roleId));
+        for (const stage of plan.pipeline) {
+            if (!roleIds.has(stage.roleId)) {
+                throw new Error(`Gatekeeper plan references role "${stage.roleId}" in pipeline but it's not in the roles array`);
+            }
+        }
+        return this.planToExecution(plan, tokensUsed);
+    }
+    /** Convert a GatekeeperPlan into BloopTeam + AgentRole[] */
+    planToExecution(plan, tokensUsed) {
+        const dynamicRoles = [];
+        for (const rp of plan.roles) {
+            // Built-in role
+            const builtin = BUILTIN_ROLES[rp.roleId];
+            if (builtin) {
+                dynamicRoles.push({
+                    ...builtin,
+                    model: rp.model ?? builtin.model,
+                    maxIterations: rp.maxIterations ?? builtin.maxIterations,
+                    allowedTools: rp.allowedTools.length > 0 ? rp.allowedTools : builtin.allowedTools,
+                });
+                continue;
+            }
+            // Template role
+            const template = ROLE_TEMPLATES[rp.roleId];
+            if (template) {
+                dynamicRoles.push({
+                    id: rp.roleId,
+                    name: rp.name || template.name,
+                    description: rp.description || template.description,
+                    systemPrompt: rp.systemPrompt || template.systemPrompt,
+                    allowedTools: rp.allowedTools.length > 0 ? rp.allowedTools : template.allowedTools,
+                    phase: rp.phase ?? template.phase,
+                    model: rp.model,
+                    maxIterations: rp.maxIterations ?? template.maxIterations,
+                });
+                continue;
+            }
+            // Fully custom role — must have systemPrompt
+            if (!rp.systemPrompt) {
+                throw new Error(`Gatekeeper created custom role "${rp.roleId}" without a systemPrompt. Custom roles must include a systemPrompt.`);
+            }
+            dynamicRoles.push({
+                id: rp.roleId,
+                name: rp.name,
+                description: rp.description,
+                systemPrompt: rp.systemPrompt,
+                allowedTools: rp.allowedTools,
+                phase: rp.phase,
+                model: rp.model,
+                maxIterations: rp.maxIterations,
+            });
+        }
+        const team = {
+            pipeline: plan.pipeline.map((s) => ({
+                phase: s.phase,
+                roleId: s.roleId,
+                canReject: s.canReject,
+                rejectTo: s.rejectTo,
+            })),
+            maxCycles: plan.maxCycles,
+        };
+        return { team, dynamicRoles, plan, tokensUsed };
+    }
+    /** Build the gatekeeper system prompt. */
+    buildPrompt(options) {
+        const config = getConfig();
+        const parts = [
+            `You are a Gatekeeper for the BeerCan autonomous agent system. Analyze the goal and compose the optimal team of agents and execution pipeline.`,
+            ``,
+            `## Available Models`,
+            `- claude-haiku-4-5-20251001 — Fast, cheap ($1/$5 per MTok). Simple tasks, summaries, data processing.`,
+            `- claude-sonnet-4-6 — Balanced ($3/$15 per MTok). Most coding, writing, analysis. 1M context.`,
+            `- claude-opus-4-6 — Most intelligent ($5/$25 per MTok). Complex architecture, agents, nuanced review. 1M context.`,
+            ``,
+            `## Built-in Roles`,
+            ...Object.entries(BUILTIN_ROLES).map(([id, r]) => `- **${id}** (${r.phase}): ${r.description}`),
+            ``,
+            `## Template Roles (for non-coding tasks)`,
+            ...Object.entries(ROLE_TEMPLATES).map(([id, r]) => `- **${id}** (${r.phase}): ${r.description}`),
+            ``,
+            `## Available Tools`,
+            `Filesystem: read_file, write_file, list_directory, exec_command`,
+            `Memory: memory_search, memory_store, memory_update, memory_link, memory_query_graph, memory_scratch`,
+            ``,
+            `## Rules`,
+            `1. Match team to the goal — don't over-engineer simple tasks.`,
+            `2. A solo agent is often best for simple goals.`,
+            `3. Use review stages only when quality matters.`,
+            `4. Pick the cheapest model that can do the job.`,
+            `5. Every pipeline roleId MUST have a matching roles entry.`,
+            `6. For built-in/template roles, you may omit systemPrompt.`,
+            `7. For custom roles, you MUST provide a systemPrompt.`,
+            `8. maxCycles: 1 for simple, 2 for medium, 3 for complex with review.`,
+            `9. Review stages that reject should have canReject: true and rejectTo.`,
+        ];
+        if (options.project.description || Object.keys(options.project.context).length > 0) {
+            parts.push(``, `## Project: ${options.project.name}`);
+            if (options.project.description)
+                parts.push(options.project.description);
+            if (Object.keys(options.project.context).length > 0) {
+                parts.push(`Context: ${JSON.stringify(options.project.context, null, 2)}`);
+            }
+        }
+        if (options.memoryContext) {
+            parts.push(``, `## Past Patterns`, options.memoryContext);
+        }
+        return parts.join("\n");
+    }
+}
+//# sourceMappingURL=gatekeeper.js.map

package/dist/core/gatekeeper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatekeeper.js","sourceRoot":"","sources":["../../src/core/gatekeeper.ts"],"names":[],"mappings":"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"}

package/dist/core/job-queue.d.ts

@@ -0,0 +1,61 @@
+import type { BeerCanDB } from "../storage/database.js";
+export interface EnqueueOptions {
+    projectSlug: string;
+    goal: string;
+    team?: string;
+    priority?: number;
+    source?: "manual" | "cron" | "event";
+    sourceId?: string;
+    extraContext?: string;
+}
+export interface Job {
+    id: string;
+    projectSlug: string;
+    goal: string;
+    team: string;
+    priority: number;
+    status: "pending" | "running" | "completed" | "failed" | "timeout";
+    source: string;
+    sourceId: string | null;
+    extraContext: string | null;
+    bloopId: string | null;
+    error: string | null;
+    createdAt: string;
+    startedAt: string | null;
+    completedAt: string | null;
+}
+export interface JobStats {
+    pending: number;
+    running: number;
+    completed: number;
+    failed: number;
+}
+export declare class JobQueue {
+    private running;
+    private maxConcurrent;
+    private db;
+    private executor;
+    constructor(db: BeerCanDB, maxConcurrent: number);
+    /** Set the bloop executor (called after engine is fully initialized) */
+    setExecutor(fn: (opts: {
+        projectSlug: string;
+        goal: string;
+        team: string;
+        extraContext?: string;
+    }) => Promise<{
+        id: string;
+        status: string;
+    }>): void;
+    /** Enqueue a new job. Returns job ID. */
+    enqueue(opts: EnqueueOptions): string;
+    /** Process the next pending job if under concurrency limit. */
+    processNext(): void;
+    private executeJob;
+    /** Get queue statistics. */
+    getStats(): JobStats;
+    /** List jobs, optionally filtered by status. */
+    listJobs(status?: string, limit?: number): Job[];
+    /** Wait for all running AND pending jobs to complete. */
+    drain(): Promise<void>;
+}
+//# sourceMappingURL=job-queue.d.ts.map

package/dist/core/job-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-queue.d.ts","sourceRoot":"","sources":["../../src/core/job-queue.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAMxD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,QAAQ,CAAgJ;gBAEpJ,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM;IAKhD,wEAAwE;IACxE,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAIpJ,yCAAyC;IACzC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAgCrC,+DAA+D;IAC/D,WAAW,IAAI,IAAI;YAyBL,UAAU;IA+BxB,4BAA4B;IAC5B,QAAQ,IAAI,QAAQ;IAIpB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,GAAG,EAAE;IAI5C,yDAAyD;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB7B"}