espetro · espetro · Aug 20, 2026 · Aug 20, 2026 · Aug 20, 2026
diff --git a/.agents/backlog-policy.md b/.agents/backlog-policy.md
@@ -0,0 +1,19 @@
+# Backlog Policy
+
+GitHub Project: https://github.com/users/espetro/projects/6
+
+## Refined task fields
+
+- **Milestone** — maps to iteration/quarter (e.g. `2026 Q3`). Create the milestone in the repo if it doesn't exist yet.
+- **Size** — effort estimate: `XS`/`S`/`M`/`L`/`XL`. Include testing + bug potential per contact surface.
+- **Start date** / **Target date** — scheduled window for the task.
+- **Label** — classification, drives client positioning: `feature`, `bug`, `cosmetic`, `infra`. Create the label in the repo if it doesn't exist yet.
+
+## Workflow
+
+1. Create a GitHub issue in `espetro/calca` with title, body, classification label, milestone.
+2. Add it to project 6: `gh project item-add 6 --owner espetro --url <issue-url>`.
+3. Set Size/Start date/Target date via `gh project item-edit --project-id <id> --id <item-id> --field-id <field-id> ...`.
+4. Reference the issue number in the PR description and in the corresponding `.agents/plans/` doc.
+
+No orphan work: every plan/implementation must link back to a refined task here.
diff --git a/apps/web/src/shared/types/canvas.ts b/apps/web/src/shared/types/canvas.ts
@@ -1,6 +1 @@
-export interface Point {
-  x: number;
-  y: number;
-}
-
-export type ToolMode = "select" | "draw-area" | "edit-component" | "comment";
+export type { Point, ToolMode } from "@app/shared";
diff --git a/apps/web/src/shared/types/comment.ts b/apps/web/src/shared/types/comment.ts
@@ -1,20 +1 @@
-export type CommentStatus = "waiting" | "working" | "done";
-
-export interface CommentMessage {
-  id: string;
-  role: "user" | "calca";
-  text: string;
-  createdAt: number;
-}
-
-export interface Comment {
-  id: string;
-  position: import("./canvas").Point; // Relative to the iteration
-  text: string;
-  number: number;
-  resolved?: boolean;
-  createdAt: number;
-  status?: CommentStatus;
-  aiResponse?: string;
-  thread?: CommentMessage[];
-}
+export type { Comment, CommentMessage, CommentStatus } from "@app/shared";
diff --git a/apps/web/src/shared/types/design.ts b/apps/web/src/shared/types/design.ts
@@ -1,36 +1 @@
-export interface DesignIteration {
-  id: string;
-  html: string;
-  label: string;
-  position: import("./canvas").Point;
-  width: number;
-  height: number;
-  prompt: string;
-  comments: import("./comment").Comment[];
-  isLoading?: boolean;
-  isRegenerating?: boolean;
-}
-
-export interface SummaryData {
-  title: string;
-  rationale: string;
-}
-
-export interface GenerationGroup {
-  id: string;
-  prompt: string;
-  iterations: DesignIteration[];
-  position: import("./canvas").Point;
-  createdAt: number;
-  summary?: SummaryData;
-}
-
-export interface CanvasImage {
-  id: string;
-  dataUrl: string; // Base64 data URI
-  name: string;
-  width: number;
-  height: number;
-  position: import("./canvas").Point;
-  thumbnail: string; // Smaller version for UI
-}
+export type { CanvasImage, DesignIteration, GenerationGroup, SummaryData } from "@app/shared";
diff --git a/apps/web/src/shared/types/pipeline.ts b/apps/web/src/shared/types/pipeline.ts
@@ -1,32 +1,2 @@
-/** Pipeline stages for multi-model generation */
-
-export type PipelineStage =
-  | "queued"
-  | "layout"
-  | "images"
-  | "compositing"
-  | "review"
-  | "refining"
-  | "done"
-  | "error";
-
-export interface PipelineStatus {
-  stage: PipelineStage;
-  progress: number; // 0-1
-  skipped?: boolean;
-  reason?: string;
-}
-
-export const STAGE_CONFIG: Record<
-  PipelineStage,
-  { label: string; progress: number; icon: string }
-> = {
-  compositing: { label: "Compositing…", progress: 0.65, icon: "🔧" },
-  done: { label: "Complete", progress: 1, icon: "✅" },
-  error: { label: "Error", progress: 0, icon: "❌" },
-  images: { label: "Adding images…", progress: 0.45, icon: "🎨" },
-  layout: { label: "Generating layout…", progress: 0.2, icon: "🏗️" },
-  queued: { label: "Queued", progress: 0, icon: "⏳" },
-  refining: { label: "Preparing next variation…", progress: 0.9, icon: "✨" },
-  review: { label: "Reviewing design…", progress: 0.8, icon: "👁️" },
-};
+export type { PipelineStage, PipelineStatus } from "@app/shared";
+export { STAGE_CONFIG } from "@app/shared";
diff --git a/bun.lock b/bun.lock
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -34,7 +34,7 @@
     "@ai-sdk/google": "^3.0.61",
     "@ai-sdk/openai-compatible": "^2.0.41",
     "@ai-sdk/provider": "3.0.8",
-    "@ai-sdk/provider-utils": "4.0.23",
+    "@ai-sdk/provider-utils": "^4.0.26",
     "@app/logger": "workspace:*",
     "ai": "^6.0.156",
     "zod": "^4.3.6"

diff --git a/packages/shared/src/index.ts b/packages/shared/src/index.ts
@@ -25,3 +25,8 @@ export {
   validateSummary,
   type SummaryOutput,
 } from "./schemas/summary";
+
+export * from "./types/canvas";
+export * from "./types/design";
+export * from "./types/comment";
+export * from "./types/pipeline";
diff --git a/packages/shared/src/types/canvas.ts b/packages/shared/src/types/canvas.ts
@@ -0,0 +1,6 @@
+export interface Point {
+  x: number;
+  y: number;
+}
+
+export type ToolMode = "select" | "draw-area" | "edit-component" | "comment";
diff --git a/packages/shared/src/types/comment.ts b/packages/shared/src/types/comment.ts
@@ -0,0 +1,22 @@
+import type { Point } from "./canvas";
+
+export type CommentStatus = "waiting" | "working" | "done";
+
+export interface CommentMessage {
+  id: string;
+  role: "user" | "calca";
+  text: string;
+  createdAt: number;
+}
+
+export interface Comment {
+  id: string;
+  position: Point; // Relative to the iteration
+  text: string;
+  number: number;
+  resolved?: boolean;
+  createdAt: number;
+  status?: CommentStatus;
+  aiResponse?: string;
+  thread?: CommentMessage[];
+}
diff --git a/packages/shared/src/types/design.ts b/packages/shared/src/types/design.ts
@@ -0,0 +1,39 @@
+import type { Point } from "./canvas";
+import type { Comment } from "./comment";
+
+export interface DesignIteration {
+  id: string;
+  html: string;
+  label: string;
+  position: Point;
+  width: number;
+  height: number;
+  prompt: string;
+  comments: Comment[];
+  isLoading?: boolean;
+  isRegenerating?: boolean;
+}
+
+export interface SummaryData {
+  title: string;
+  rationale: string;
+}
+
+export interface GenerationGroup {
+  id: string;
+  prompt: string;
+  iterations: DesignIteration[];
+  position: Point;
+  createdAt: number;
+  summary?: SummaryData;
+}
+
+export interface CanvasImage {
+  id: string;
+  dataUrl: string; // Base64 data URI
+  name: string;
+  width: number;
+  height: number;
+  position: Point;
+  thumbnail: string; // Smaller version for UI
+}
diff --git a/packages/shared/src/types/pipeline.ts b/packages/shared/src/types/pipeline.ts
@@ -0,0 +1,32 @@
+/** Pipeline stages for multi-model generation */
+
+export type PipelineStage =
+  | "queued"
+  | "layout"
+  | "images"
+  | "compositing"
+  | "review"
+  | "refining"
+  | "done"
+  | "error";
+
+export interface PipelineStatus {
+  stage: PipelineStage;
+  progress: number; // 0-1
+  skipped?: boolean;
+  reason?: string;
+}
+
+export const STAGE_CONFIG: Record<
+  PipelineStage,
+  { label: string; progress: number; icon: string }
+> = {
+  compositing: { label: "Compositing…", progress: 0.65, icon: "🔧" },
+  done: { label: "Complete", progress: 1, icon: "✅" },
+  error: { label: "Error", progress: 0, icon: "❌" },
+  images: { label: "Adding images…", progress: 0.45, icon: "🎨" },
+  layout: { label: "Generating layout…", progress: 0.2, icon: "🏗️" },
+  queued: { label: "Queued", progress: 0, icon: "⏳" },
+  refining: { label: "Preparing next variation…", progress: 0.9, icon: "✨" },
+  review: { label: "Reviewing design…", progress: 0.8, icon: "👁️" },
+};