@hham21/circe 0.4.0

package/dist/orchestration/loop.d.ts

@@ -0,0 +1,25 @@
+import type { Runnable } from "../types.js";
+import type { EventBus, RetryPolicy } from "../events.js";
+export interface LoopOptions<TEval = unknown> {
+    maxRounds?: number;
+    stopWhen?: (result: TEval) => boolean;
+    retryPolicy?: RetryPolicy;
+    eventBus?: EventBus;
+}
+export declare class Loop<TIn = unknown, TProducer = unknown, TEval = unknown> implements Runnable<TIn, TProducer> {
+    name?: string;
+    private agents;
+    private maxRounds;
+    private stopWhen;
+    private retryPolicy;
+    private eventBus;
+    private _lastMetrics;
+    private _lastProducerResult;
+    private _lastEvaluatorResult;
+    constructor(...args: [...Runnable<any, any>[], LoopOptions<TEval>] | Runnable<any, any>[]);
+    get lastMetrics(): import("../types.js").MetricsSnapshot | null;
+    get lastEvaluatorResult(): TEval | null;
+    run(input: TIn): Promise<TProducer>;
+    private executeRound;
+    private runAgent;
+}

package/dist/orchestration/loop.js

@@ -0,0 +1,81 @@
+import { runWithOptionalRetry, errorMessage } from "../events.js";
+import { parseTrailingOptions, createMetrics, accumulateMetrics } from "../utils.js";
+const DEFAULT_MAX_ROUNDS = 3;
+export class Loop {
+    name;
+    agents;
+    maxRounds;
+    stopWhen;
+    retryPolicy;
+    eventBus;
+    _lastMetrics = null;
+    _lastProducerResult = null;
+    _lastEvaluatorResult = null;
+    constructor(...args) {
+        const { agents, options } = parseTrailingOptions(args);
+        if (agents.length < 2) {
+            throw new Error("Loop requires at least two agents");
+        }
+        this.agents = agents;
+        this.maxRounds = options.maxRounds ?? DEFAULT_MAX_ROUNDS;
+        this.stopWhen = options.stopWhen ?? null;
+        this.retryPolicy = options.retryPolicy ?? null;
+        this.eventBus = options.eventBus ?? null;
+    }
+    get lastMetrics() { return this._lastMetrics; }
+    get lastEvaluatorResult() { return this._lastEvaluatorResult; }
+    async run(input) {
+        this._lastMetrics = null;
+        this._lastProducerResult = null;
+        this._lastEvaluatorResult = null;
+        const accumulated = createMetrics();
+        let result = input;
+        try {
+            for (let round = 0; round < this.maxRounds; round++) {
+                this.eventBus?.emit({ type: "round:start", round, timestamp: Date.now() });
+                result = await this.executeRound(round, result, accumulated);
+                if (this.stopWhen?.(result)) {
+                    this._lastMetrics = { ...accumulated };
+                    return this._lastProducerResult;
+                }
+            }
+            this._lastMetrics = { ...accumulated };
+            return result;
+        }
+        finally {
+            if (!this._lastMetrics) {
+                this._lastMetrics = { ...accumulated };
+            }
+        }
+    }
+    async executeRound(round, input, accumulated) {
+        try {
+            let result = input;
+            let roundCost = 0;
+            for (let i = 0; i < this.agents.length; i++) {
+                const agent = this.agents[i];
+                result = await this.runAgent(agent, result);
+                const m = agent.lastMetrics;
+                accumulateMetrics(accumulated, m);
+                if (m)
+                    roundCost += m.cost;
+                if (i === 0) {
+                    this._lastProducerResult = result;
+                }
+                if (i === this.agents.length - 1) {
+                    this._lastEvaluatorResult = result;
+                }
+            }
+            this.eventBus?.emit({ type: "round:done", round, result, cost: roundCost || undefined, timestamp: Date.now() });
+            return result;
+        }
+        catch (err) {
+            this.eventBus?.emit({ type: "round:error", round, error: errorMessage(err), timestamp: Date.now() });
+            throw new Error(`[Loop:round-${round + 1}] ${errorMessage(err)}`);
+        }
+    }
+    async runAgent(agent, input) {
+        return runWithOptionalRetry(agent, input, this.retryPolicy, this.eventBus);
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/orchestration/loop.js.map

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

package/dist/orchestration/parallel.d.ts

@@ -0,0 +1,27 @@
+import type { Runnable } from "../types.js";
+import type { EventBus, RetryPolicy } from "../events.js";
+export interface ParallelOptions {
+    throwOnError?: boolean;
+    retryPolicy?: RetryPolicy;
+    eventBus?: EventBus;
+}
+export type ParallelResult<T = unknown> = Record<string, {
+    status: "fulfilled";
+    value: T;
+} | {
+    status: "rejected";
+    error: string;
+}>;
+export declare class Parallel<TIn = unknown, TOut = unknown> implements Runnable<TIn, ParallelResult<TOut>> {
+    name?: string;
+    private agents;
+    private throwOnError;
+    private retryPolicy;
+    private eventBus;
+    private _lastMetrics;
+    constructor(...args: [...Runnable<TIn, TOut>[], ParallelOptions] | Runnable<TIn, TOut>[]);
+    get lastMetrics(): import("../types.js").MetricsSnapshot | null;
+    run(input: TIn): Promise<ParallelResult<TOut>>;
+    private runAgent;
+    private collectResults;
+}

package/dist/orchestration/parallel.js

@@ -0,0 +1,78 @@
+import { runWithOptionalRetry, errorMessage } from "../events.js";
+import { parseTrailingOptions, createMetrics, accumulateMetrics } from "../utils.js";
+export class Parallel {
+    name;
+    agents;
+    throwOnError;
+    retryPolicy;
+    eventBus;
+    _lastMetrics = null;
+    constructor(...args) {
+        const { agents, options } = parseTrailingOptions(args);
+        if (agents.length === 0) {
+            throw new Error("Parallel requires at least one agent");
+        }
+        this.agents = agents;
+        this.throwOnError = options.throwOnError ?? true;
+        this.retryPolicy = options.retryPolicy ?? null;
+        this.eventBus = options.eventBus ?? null;
+    }
+    get lastMetrics() { return this._lastMetrics; }
+    async run(input) {
+        this._lastMetrics = null;
+        const settledOutcomes = await Promise.allSettled(this.agents.map((agent, index) => this.runAgent(agent, input, index)));
+        const accumulated = createMetrics();
+        for (const a of this.agents)
+            accumulateMetrics(accumulated, a.lastMetrics);
+        this._lastMetrics = accumulated;
+        return this.collectResults(settledOutcomes);
+    }
+    async runAgent(agent, input, index) {
+        const name = agent.name ?? `agent-${index}`;
+        this.eventBus?.emit({ type: "branch:start", branch: name, timestamp: Date.now() });
+        try {
+            const result = await runWithOptionalRetry(agent, input, this.retryPolicy, this.eventBus);
+            const metrics = agent.lastMetrics;
+            this.eventBus?.emit({
+                type: "branch:done",
+                branch: name,
+                result,
+                cost: metrics?.cost,
+                timestamp: Date.now(),
+            });
+            return { name, result };
+        }
+        catch (err) {
+            this.eventBus?.emit({
+                type: "branch:error",
+                branch: name,
+                error: errorMessage(err),
+                timestamp: Date.now(),
+            });
+            throw err;
+        }
+    }
+    collectResults(settledOutcomes) {
+        const results = {};
+        let firstError = null;
+        for (const [i, outcome] of settledOutcomes.entries()) {
+            if (outcome.status === "fulfilled") {
+                const { name, result } = outcome.value;
+                results[name] = { status: "fulfilled", value: result };
+            }
+            else {
+                const name = this.agents[i].name ?? `agent-${i}`;
+                const errorMsg = outcome.reason?.message ?? String(outcome.reason);
+                results[name] = { status: "rejected", error: errorMsg };
+                if (!firstError) {
+                    firstError = outcome.reason instanceof Error ? outcome.reason : new Error(errorMsg);
+                }
+            }
+        }
+        if (this.throwOnError && firstError) {
+            throw firstError;
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=parallel.js.map

package/dist/orchestration/parallel.js.map

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

package/dist/orchestration/pipeline.d.ts

@@ -0,0 +1,23 @@
+import type { Runnable } from "../types.js";
+import type { EventBus, RetryPolicy, OrchestratorEvent } from "../events.js";
+export interface PipelineOptions {
+    retryPolicy?: RetryPolicy;
+    eventBus?: EventBus;
+}
+export declare class Pipeline<TIn = unknown, TOut = unknown> implements Runnable<TIn, TOut> {
+    private agents;
+    private retryPolicy;
+    private eventBus;
+    private _lastMetrics;
+    constructor(...args: [...Runnable<any, any>[], PipelineOptions] | Runnable<any, any>[]);
+    get lastMetrics(): import("../types.js").MetricsSnapshot | null;
+    run(input: TIn): Promise<TOut>;
+    resume(history: OrchestratorEvent[], input: TIn): Promise<TOut>;
+    private runStep;
+    private findLastCompletedStep;
+    private emitPipelineDone;
+}
+export declare function pipe<A, B>(s1: Runnable<A, B>, options?: PipelineOptions): Pipeline<A, B>;
+export declare function pipe<A, B, C>(s1: Runnable<A, B>, s2: Runnable<B, C>, options?: PipelineOptions): Pipeline<A, C>;
+export declare function pipe<A, B, C, D>(s1: Runnable<A, B>, s2: Runnable<B, C>, s3: Runnable<C, D>, options?: PipelineOptions): Pipeline<A, D>;
+export declare function pipe<A, B, C, D, E>(s1: Runnable<A, B>, s2: Runnable<B, C>, s3: Runnable<C, D>, s4: Runnable<D, E>, options?: PipelineOptions): Pipeline<A, E>;

package/dist/orchestration/pipeline.js

@@ -0,0 +1,100 @@
+import { runWithOptionalRetry, errorMessage } from "../events.js";
+import { parseTrailingOptions, createMetrics, accumulateMetrics } from "../utils.js";
+export class Pipeline {
+    agents;
+    retryPolicy;
+    eventBus;
+    _lastMetrics = null;
+    constructor(...args) {
+        const { agents, options } = parseTrailingOptions(args);
+        if (agents.length === 0) {
+            throw new Error("Pipeline requires at least one agent");
+        }
+        this.agents = agents;
+        this.retryPolicy = options.retryPolicy ?? null;
+        this.eventBus = options.eventBus ?? null;
+    }
+    get lastMetrics() { return this._lastMetrics; }
+    async run(input) {
+        this._lastMetrics = null;
+        const accumulated = createMetrics();
+        let result = input;
+        try {
+            for (let i = 0; i < this.agents.length; i++) {
+                result = await this.runStep(this.agents[i], i, result);
+                accumulateMetrics(accumulated, this.agents[i].lastMetrics);
+            }
+            this._lastMetrics = { ...accumulated };
+            this.emitPipelineDone();
+            return result;
+        }
+        finally {
+            if (!this._lastMetrics) {
+                this._lastMetrics = { ...accumulated };
+            }
+        }
+    }
+    resume(history, input) {
+        const { lastCompletedStep, lastOutput } = this.findLastCompletedStep(history, input);
+        if (lastCompletedStep < 0) {
+            return this.run(input);
+        }
+        const remainingAgents = this.agents.slice(lastCompletedStep + 1);
+        if (remainingAgents.length === 0) {
+            return Promise.resolve(lastOutput);
+        }
+        const resumePipeline = new Pipeline(...remainingAgents, {
+            retryPolicy: this.retryPolicy ?? undefined,
+            eventBus: this.eventBus ?? undefined,
+        });
+        return resumePipeline.run(lastOutput);
+    }
+    async runStep(agent, stepIndex, input) {
+        const agentName = agent.name ?? `step-${stepIndex}`;
+        this.eventBus?.emit({ type: "step:start", step: stepIndex, agent: agentName, timestamp: Date.now() });
+        try {
+            const output = await runWithOptionalRetry(agent, input, this.retryPolicy, this.eventBus);
+            const metrics = agent.lastMetrics;
+            this.eventBus?.emit({
+                type: "step:done",
+                step: stepIndex,
+                agent: agentName,
+                output,
+                cost: metrics?.cost,
+                tokens: metrics ? [metrics.inputTokens, metrics.outputTokens] : undefined,
+                timestamp: Date.now(),
+            });
+            return output;
+        }
+        catch (err) {
+            this.eventBus?.emit({
+                type: "step:error",
+                step: stepIndex,
+                agent: agentName,
+                error: errorMessage(err),
+                timestamp: Date.now(),
+            });
+            throw new Error(`[Pipeline:step-${stepIndex}/${agentName}] ${errorMessage(err)}`);
+        }
+    }
+    findLastCompletedStep(history, input) {
+        for (let i = history.length - 1; i >= 0; i--) {
+            const event = history[i];
+            if (event.type === "step:done") {
+                return { lastCompletedStep: event.step, lastOutput: event.output };
+            }
+        }
+        return { lastCompletedStep: -1, lastOutput: input };
+    }
+    emitPipelineDone() {
+        const summary = this.eventBus?.getCostSummary();
+        if (this.eventBus && summary) {
+            this.eventBus.emit({ type: "pipeline:done", totalCost: summary.total, timestamp: Date.now() });
+        }
+    }
+}
+export function pipe(...args) {
+    const { agents, options } = parseTrailingOptions(args);
+    return new Pipeline(...agents, options);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/orchestration/pipeline.js.map

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

package/dist/orchestration/sprint.d.ts

@@ -0,0 +1,21 @@
+import type { Runnable } from "../types.js";
+import type { EventBus, RetryPolicy } from "../events.js";
+export interface SprintOptions {
+    retryPolicy?: RetryPolicy;
+    eventBus?: EventBus;
+}
+export declare class Sprint<TIn = unknown, TOut = unknown> implements Runnable<TIn, {
+    sprintResults: TOut[];
+}> {
+    name?: string;
+    private runner;
+    private retryPolicy;
+    private eventBus;
+    private _lastMetrics;
+    constructor(runner: Runnable<any, TOut>, options?: SprintOptions);
+    get lastMetrics(): import("../types.js").MetricsSnapshot | null;
+    run(spec: TIn): Promise<{
+        sprintResults: TOut[];
+    }>;
+    private extractSprintDefinitions;
+}

package/dist/orchestration/sprint.js

@@ -0,0 +1,56 @@
+import { runWithOptionalRetry, errorMessage } from "../events.js";
+import { createMetrics, accumulateMetrics } from "../utils.js";
+export class Sprint {
+    name;
+    runner;
+    retryPolicy;
+    eventBus;
+    _lastMetrics = null;
+    constructor(runner, options) {
+        this.runner = runner;
+        this.retryPolicy = options?.retryPolicy ?? null;
+        this.eventBus = options?.eventBus ?? null;
+    }
+    get lastMetrics() { return this._lastMetrics; }
+    async run(spec) {
+        this._lastMetrics = null;
+        const accumulated = createMetrics();
+        const definitions = this.extractSprintDefinitions(spec);
+        const sprintResults = [];
+        try {
+            for (let index = 0; index < definitions.length; index++) {
+                const sprintDef = definitions[index];
+                this.eventBus?.emit({ type: "sprint:start", index, definition: sprintDef, timestamp: Date.now() });
+                try {
+                    const result = await runWithOptionalRetry(this.runner, sprintDef, this.retryPolicy, this.eventBus);
+                    sprintResults.push(result);
+                    const m = this.runner.lastMetrics;
+                    accumulateMetrics(accumulated, m);
+                    this.eventBus?.emit({ type: "sprint:done", index, result, cost: m?.cost, timestamp: Date.now() });
+                }
+                catch (error) {
+                    this.eventBus?.emit({
+                        type: "sprint:error",
+                        index,
+                        error: errorMessage(error),
+                        timestamp: Date.now(),
+                    });
+                    throw new Error(`[Sprint:item-${index}] ${errorMessage(error)}`);
+                }
+            }
+            this._lastMetrics = { ...accumulated };
+            return { sprintResults };
+        }
+        finally {
+            if (!this._lastMetrics) {
+                this._lastMetrics = { ...accumulated };
+            }
+        }
+    }
+    extractSprintDefinitions(spec) {
+        if (spec == null || typeof spec !== "object")
+            return [];
+        return spec.sprints ?? [];
+    }
+}
+//# sourceMappingURL=sprint.js.map

package/dist/orchestration/sprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint.js","sourceRoot":"","sources":["../../src/orchestration/sprint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQ/D,MAAM,OAAO,MAAM;IACjB,IAAI,CAAU;IACN,MAAM,CAAsB;IAC5B,WAAW,CAAqB;IAChC,QAAQ,CAAkB;IAC1B,YAAY,GAA8B,IAAI,CAAC;IAEvD,YAAY,MAA2B,EAAE,OAAuB;QAC9D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,IAAI,WAAW,KAAK,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAE/C,KAAK,CAAC,GAAG,CAAC,IAAS;QACjB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,MAAM,WAAW,GAAG,aAAa,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,aAAa,GAAW,EAAE,CAAC;QAEjC,IAAI,CAAC;YACH,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBACxD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAEnG,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACnG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAE3B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;oBAClC,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;oBAElC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACpG,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;wBAClB,IAAI,EAAE,cAAc;wBACpB,KAAK;wBACL,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;wBAC1B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;qBACtB,CAAC,CAAC;oBACH,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;YAED,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;YACvC,OAAO,EAAE,aAAa,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvB,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,wBAAwB,CAAC,IAAa;QAC5C,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACxD,OAAQ,IAAgC,CAAC,OAAoB,IAAI,EAAE,CAAC;IACtE,CAAC;CACF"}

package/dist/presets/frontend.d.ts

@@ -0,0 +1,8 @@
+import { Loop } from "../orchestration/loop.js";
+interface FrontendDesignOptions {
+    model?: string;
+    iterations?: number;
+    passThreshold?: number;
+}
+export declare function frontendDesign(options?: FrontendDesignOptions): Loop;
+export {};

package/dist/presets/frontend.js

@@ -0,0 +1,113 @@
+import { Agent } from "../agent.js";
+import { QAReportSchema, hasQAPassed } from "../handoff.js";
+import { Loop } from "../orchestration/loop.js";
+import { PLAYWRIGHT_MCP_SERVER } from "../utils.js";
+const DEFAULT_ITERATIONS = 10;
+const DEFAULT_PASS_THRESHOLD = 9.5;
+export function frontendDesign(options) {
+    const iterations = options?.iterations ?? DEFAULT_ITERATIONS;
+    const passThreshold = options?.passThreshold ?? DEFAULT_PASS_THRESHOLD;
+    const generator = createGenerator(passThreshold);
+    const evaluator = createEvaluator(passThreshold);
+    return new Loop(generator, evaluator, {
+        maxRounds: iterations,
+        stopWhen: hasQAPassed,
+    });
+}
+function createGenerator(passThreshold) {
+    return new Agent({
+        name: "generator",
+        prompt: `You are an elite frontend craftsperson. Build pure HTML/CSS/JS (no frameworks).
+
+Rules:
+- Create index.html in the working directory
+- Commit each round to git
+- If _scores.md exists, read it to track progress. If it doesn't exist, this is the first round — just build.
+- If scores plateau, pivot your aesthetic approach entirely — try a completely different visual direction
+- If scores drop, git checkout to restore the best version
+- Do NOT start a web server. The evaluator handles that.
+- Do NOT wait for scores or poll for files. Just build and finish.
+
+Priority order:
+1. Fix any bugs tagged CRITICAL or BUG in _scores.md BEFORE adding new features
+2. Address specific feedback items from the evaluator
+3. Add new features or improvements
+
+Strategic decisions:
+- After each evaluation, decide: refine the current direction if scores are trending well, or pivot to an entirely different aesthetic if the approach is not working
+- The best designs are museum quality — pursue a distinct mood and identity, not safe defaults
+
+Images:
+- Download real images using curl and save to an img/ directory in the working directory
+- Use public domain sources: Wikimedia Commons, Met Museum Open Access, Rijksmuseum API
+- Example: curl -sL -o img/painting.jpg "https://upload.wikimedia.org/wikipedia/commons/thumb/..."
+- NEVER use external URLs in <img src> — always reference local files (e.g., src="img/painting.jpg")
+- NEVER substitute real images with SVG shapes or gradient placeholders
+
+Target: ALL criteria must score ${passThreshold}/10 or higher.`,
+    });
+}
+function createEvaluator(passThreshold) {
+    return new Agent({
+        name: "evaluator",
+        prompt: `You are a ruthless design critic with no memory of previous rounds. Load the design-critique skill via use_skill("design-critique") for detailed methodology, anti-patterns, and scoring guide.
+
+First, kill any existing serve process and start fresh:
+  pkill -f "serve -l 8080" 2>/dev/null; sleep 1; npx serve -l 8080 . &
+Then wait 3 seconds and evaluate the design at http://localhost:8080.
+
+CRITICAL RULES:
+- Do NOT read _scores.md. Ever. It is not for you.
+- Do NOT reference, check, or verify "previous feedback" — you have none.
+- You are seeing this site for the FIRST TIME. Evaluate absolute quality, not improvement.
+- Do NOT read any file except index.html and CSS/JS files linked from it.
+
+Determine the current round number by counting existing screenshot folders:
+  ROUND=$(( $(ls -d ./screenshots/round-* 2>/dev/null | wc -l) + 1 ))
+  mkdir -p ./screenshots/round-$ROUND
+
+Use Playwright MCP to navigate the live page directly — click through it, scroll, interact with elements, test responsiveness at different viewports. Do not score from a static screenshot alone.
+
+Score each criterion (1-10):
+- design_quality (weight 0.35): Does the design feel like a coherent whole rather than a collection of parts? Strong work means colors, typography, layout, imagery combine to create a distinct mood and identity.
+- originality (weight 0.35): Is there evidence of custom creative decisions, or is this template layouts, library defaults, and AI-generated patterns? Unmodified stock components or telltale AI slop (purple gradients over white cards) fail here.
+- craft (weight 0.15): Typography hierarchy, spacing consistency, color harmony, contrast ratios. A competence check — most reasonable implementations do fine; failing means broken fundamentals.
+- functionality (weight 0.15): Usability independent of aesthetics. Can users understand the interface, find primary actions, and complete tasks without guessing?
+
+SCORING CALIBRATION:
+- 9-10: Exceptional. A professional designer would be impressed. Distinct identity that could not be mistaken for another site.
+- 7-8: Good. Competent and polished, but you've seen this layout before. Lacks a signature element.
+- 5-6: Generic. Template-quality. AI slop patterns. Safe choices everywhere.
+- 3-4: Poor. Broken fundamentals, clashing styles, or amateur execution.
+A score of 9+ means you would genuinely bookmark this site. Do not give 9 just because it is "good enough."
+
+Pass only if ALL criteria >= ${passThreshold}/10.
+APPEND scores to ./_scores.md using Bash (do NOT overwrite — the generator tracks score trends across rounds):
+  cat >> ./_scores.md << EOF
+  ## Round $ROUND
+  | design_quality | originality | craft | functionality | passed |
+  |---|---|---|---|---|
+  | X | X | X | X | YES/NO |
+  EOF
+
+When giving feedback:
+- Tag critical bugs as "CRITICAL BUG:"
+- Be specific: exact elements, colors, sizes, font weights
+- Suggest concrete fixes, not vague directions
+
+Output JSON:
+{
+  "passed": true/false,
+  "scores": {"design_quality": N, "originality": N, "craft": N, "functionality": N},
+  "feedback": ["specific feedback 1", ...]
+}`,
+        skills: ["design-critique"],
+        tools: ["Bash", "Glob"],
+        contextStrategy: "reset",
+        mcpServers: {
+            playwright: PLAYWRIGHT_MCP_SERVER,
+        },
+        outputSchema: QAReportSchema,
+    });
+}
+//# sourceMappingURL=frontend.js.map

package/dist/presets/frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend.js","sourceRoot":"","sources":["../../src/presets/frontend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAQnC,MAAM,UAAU,cAAc,CAAC,OAA+B;IAC5D,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,kBAAkB,CAAC;IAC7D,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,sBAAsB,CAAC;IAEvE,MAAM,SAAS,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IAEjD,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE;QACpC,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,aAAqB;IAC5C,OAAO,IAAI,KAAK,CAAC;QACf,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA2BsB,aAAa,gBAAgB;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,aAAqB;IAC5C,OAAO,IAAI,KAAK,CAAC;QACf,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BA+BmB,aAAa;;;;;;;;;;;;;;;;;;;EAmB1C;QACE,MAAM,EAAE,CAAC,iBAAiB,CAAC;QAC3B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,OAAO;QACxB,UAAU,EAAE;YACV,UAAU,EAAE,qBAAqB;SAClC;QACD,YAAY,EAAE,cAAc;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/dist/presets/fullstack.d.ts

@@ -0,0 +1,9 @@
+import { Pipeline } from "../orchestration/pipeline.js";
+interface FullstackOptions {
+    model?: string;
+    maxRounds?: number;
+    evaluatorCriteria?: Record<string, number>;
+    passThreshold?: number;
+}
+export declare function fullstackApp(options?: FullstackOptions): Pipeline;
+export {};