factory-factory 0.2.8 → 0.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "factory-factory",
-  "version": "0.2.8",
-  "description": "Workspace-based coding environment for running multiple Claude Code sessions in parallel",
+  "version": "0.3.0",
+  "description": "Workspace-based coding environment for running multiple Claude Code and Codex sessions in parallel",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -15,6 +15,7 @@
   "keywords": [
     "claude",
     "claude-code",
+    "codex",
     "ai",
     "coding",
     "workspace",
@@ -39,38 +40,44 @@
     "scripts/postinstall.mjs"
   ],
   "scripts": {
-    "dev": "node scripts/ensure-native-modules.mjs node && tsx src/cli/index.ts serve --dev",
-    "build": "node scripts/check-ambiguous-relative-imports.mjs && rm -rf dist && tsc -p tsconfig.backend.json && tsc-alias -p tsconfig.backend.json --resolve-full-paths && cp -r prompts dist/ && vite build",
+    "dev": "pnpm --filter @factory-factory/core build && node scripts/ensure-native-modules.mjs node && tsx src/cli/index.ts serve --dev",
+    "build": "pnpm --filter @factory-factory/core build && node scripts/check-ambiguous-relative-imports.mjs && rm -rf dist && tsc -p tsconfig.backend.json && tsc-alias -p tsconfig.backend.json --resolve-full-paths && cp -r prompts dist/ && vite build",
     "build:storybook": "storybook build",
-    "start": "node scripts/ensure-native-modules.mjs node && tsx src/cli/index.ts serve",
-    "test": "node scripts/ensure-native-modules.mjs node && vitest run",
-    "test:watch": "node scripts/ensure-native-modules.mjs node && vitest",
-    "test:coverage": "node scripts/ensure-native-modules.mjs node && vitest run --coverage",
+    "start": "pnpm --filter @factory-factory/core build && node scripts/ensure-native-modules.mjs node && tsx src/cli/index.ts serve",
+    "test": "pnpm --filter @factory-factory/core build && node scripts/ensure-native-modules.mjs node && vitest run",
+    "test:watch": "pnpm --filter @factory-factory/core build && node scripts/ensure-native-modules.mjs node && vitest",
+    "test:coverage": "pnpm --filter @factory-factory/core build && node scripts/ensure-native-modules.mjs node && vitest run --coverage",
+    "test:integration": "pnpm --filter @factory-factory/core build && node scripts/ensure-native-modules.mjs node && vitest run \"src/backend/**/*.integration.test.ts\"",
+    "check:coverage:critical": "node scripts/check-critical-coverage.mjs",
     "check": "biome check . && pnpm check:ownership",
     "check:imports": "node scripts/check-ambiguous-relative-imports.mjs",
     "check:biome-ignores": "node scripts/check-biome-ignores.mjs",
     "check:ownership": "node scripts/check-single-writer.mjs",
+    "check:codex-schema": "node scripts/check-codex-schema-drift.mjs",
+    "check:codex-schema:update": "node scripts/check-codex-schema-drift.mjs --update",
     "check:fix": "biome check --write .",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "pnpm --filter @factory-factory/core build && tsc --noEmit",
     "db:migrate": "prisma migrate dev",
     "db:generate": "prisma generate",
     "db:studio": "prisma studio",
-    "storybook": "storybook dev -p 6006",
+    "storybook": "pnpm --filter @factory-factory/core build && storybook dev -p 6006",
     "dev:electron": "node scripts/ensure-native-modules.mjs electron && tsc -p tsconfig.electron.json && concurrently \"pnpm dev:backend\" \"pnpm dev:frontend\" \"wait-on http://localhost:5173 && VITE_DEV_SERVER_URL=http://localhost:5173 electron .\"",
-    "dev:backend": "BACKEND_PORT=3001 tsx watch src/backend/index.ts",
+    "dev:backend": "pnpm --filter @factory-factory/core build && BACKEND_PORT=3001 tsx watch src/backend/index.ts",
     "dev:frontend": "BACKEND_URL=http://localhost:3001 vite",
     "build:electron": "pnpm build && pnpm exec tsc -p tsconfig.electron.json && node scripts/ensure-native-modules.mjs electron && electron-builder",
     "rebuild:electron": "electron-rebuild -f -m . -o better-sqlite3,node-pty",
     "start:electron": "electron .",
     "postinstall": "node scripts/postinstall.mjs",
     "prepare": "husky",
-    "deps:check": "depcruise src --config .dependency-cruiser.cjs",
+    "deps:check": "depcruise src electron --config .dependency-cruiser.cjs",
     "knip": "knip --include files,dependencies,unlisted"
   },
   "dependencies": {
+    "@agentclientprotocol/sdk": "0.14.1",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
+    "@factory-factory/core": "workspace:*",
     "@hookform/resolvers": "^5.2.2",
     "@prisma/adapter-better-sqlite3": "^7.3.0",
     "@prisma/client": "^7.3.0",
@@ -109,6 +116,8 @@
     "@trpc/server": "^11.9.0",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
+    "@zed-industries/claude-code-acp": "0.16.1",
+    "@zed-industries/codex-acp": "0.9.2",
     "better-sqlite3": "^12.6.2",
     "chalk": "^5.6.2",
     "class-variance-authority": "^0.7.1",
@@ -137,6 +146,7 @@
     "react-router": "^7.13.0",
     "react-syntax-highlighter": "^16.1.0",
     "recharts": "3.7.0",
+    "refractor": "^5.0.0",
     "rehype-raw": "^7.0.0",
     "rehype-sanitize": "^6.0.0",
     "remark-gfm": "^4.0.1",

package/prisma/migrations/20260212163000_agent_session_provider_cutover/migration.sql

@@ -0,0 +1,112 @@
+-- Phase 3 provider-aware session model cutover.
+-- Replaces ClaudeSession storage with unified AgentSession while preserving IDs/timestamps.
+
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+
+-- Add provider-default resolution fields.
+ALTER TABLE "Workspace" ADD COLUMN "defaultSessionProvider" TEXT NOT NULL DEFAULT 'WORKSPACE_DEFAULT';
+ALTER TABLE "Workspace" ADD COLUMN "ratchetSessionProvider" TEXT NOT NULL DEFAULT 'WORKSPACE_DEFAULT';
+ALTER TABLE "UserSettings" ADD COLUMN "defaultSessionProvider" TEXT NOT NULL DEFAULT 'CLAUDE';
+
+-- Create unified provider-aware session table.
+CREATE TABLE "AgentSession" (
+    "id" TEXT NOT NULL PRIMARY KEY,
+    "workspaceId" TEXT NOT NULL,
+    "name" TEXT,
+    "workflow" TEXT NOT NULL,
+    "model" TEXT NOT NULL DEFAULT 'sonnet',
+    "status" TEXT NOT NULL DEFAULT 'IDLE',
+    "provider" TEXT NOT NULL,
+    "providerSessionId" TEXT,
+    "providerProjectPath" TEXT,
+    "providerProcessPid" INTEGER,
+    "providerMetadata" JSONB,
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "AgentSession_workspaceId_fkey"
+      FOREIGN KEY ("workspaceId") REFERENCES "Workspace" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- Locked backfill mapping from #960.
+INSERT INTO "AgentSession" (
+    "id",
+    "workspaceId",
+    "name",
+    "workflow",
+    "model",
+    "status",
+    "provider",
+    "providerSessionId",
+    "providerProjectPath",
+    "providerProcessPid",
+    "providerMetadata",
+    "createdAt",
+    "updatedAt"
+)
+SELECT
+    "id",
+    "workspaceId",
+    "name",
+    "workflow",
+    "model",
+    "status",
+    'CLAUDE',
+    "claudeSessionId",
+    "claudeProjectPath",
+    "claudeProcessPid",
+    NULL,
+    "createdAt",
+    "updatedAt"
+FROM "ClaudeSession";
+
+-- Migration safety checks: row counts + field mapping correctness.
+CREATE TEMP TABLE "_migration_verify_row_counts" (
+    "sourceCount" INTEGER NOT NULL,
+    "targetCount" INTEGER NOT NULL,
+    CHECK ("sourceCount" = "targetCount")
+);
+INSERT INTO "_migration_verify_row_counts" ("sourceCount", "targetCount")
+SELECT (SELECT COUNT(*) FROM "ClaudeSession"), (SELECT COUNT(*) FROM "AgentSession");
+
+CREATE TEMP TABLE "_migration_verify_locked_mapping" (
+    "isValid" INTEGER NOT NULL,
+    CHECK ("isValid" = 1)
+);
+INSERT INTO "_migration_verify_locked_mapping" ("isValid")
+SELECT CASE
+  WHEN (
+    SELECT COUNT(*)
+    FROM "ClaudeSession" c
+    JOIN "AgentSession" a ON a."id" = c."id"
+    WHERE a."workspaceId" = c."workspaceId"
+      AND a."name" IS c."name"
+      AND a."workflow" = c."workflow"
+      AND a."model" = c."model"
+      AND a."status" = c."status"
+      AND a."provider" = 'CLAUDE'
+      AND a."providerSessionId" IS c."claudeSessionId"
+      AND a."providerProjectPath" IS c."claudeProjectPath"
+      AND a."providerProcessPid" IS c."claudeProcessPid"
+      AND a."providerMetadata" IS NULL
+      AND a."createdAt" = c."createdAt"
+      AND a."updatedAt" = c."updatedAt"
+  ) = (SELECT COUNT(*) FROM "ClaudeSession")
+  THEN 1
+  ELSE 0
+END;
+
+DROP TABLE "_migration_verify_row_counts";
+DROP TABLE "_migration_verify_locked_mapping";
+
+-- Required indexes for first cutover.
+CREATE INDEX "AgentSession_workspaceId_idx" ON "AgentSession"("workspaceId");
+CREATE INDEX "AgentSession_status_idx" ON "AgentSession"("status");
+CREATE INDEX "AgentSession_provider_idx" ON "AgentSession"("provider");
+CREATE INDEX "AgentSession_workspaceId_provider_idx" ON "AgentSession"("workspaceId", "provider");
+
+-- Remove legacy table after successful backfill checks.
+DROP TABLE "ClaudeSession";
+
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;

package/prisma/schema.prisma

@@ -28,6 +28,17 @@ enum SessionStatus {
   FAILED
 }
 
+enum SessionProvider {
+  CLAUDE
+  CODEX
+}
+
+enum WorkspaceProviderSelection {
+  WORKSPACE_DEFAULT
+  CLAUDE
+  CODEX
+}
+
 enum PRState {
   NONE
   DRAFT
@@ -148,7 +159,9 @@ model Workspace {
   prUrl               String?
   githubIssueNumber   Int?
   githubIssueUrl      String?
-  claudeSessions      ClaudeSession[]
+  defaultSessionProvider WorkspaceProviderSelection @default(WORKSPACE_DEFAULT)
+  ratchetSessionProvider WorkspaceProviderSelection @default(WORKSPACE_DEFAULT)
+  agentSessions       AgentSession[]
   terminalSessions    TerminalSession[]
   createdAt           DateTime          @default(now())
   updatedAt           DateTime          @updatedAt
@@ -192,22 +205,26 @@ model Workspace {
   @@index([projectId, cachedKanbanColumn])
 }
 
-model ClaudeSession {
-  id               String        @id @default(cuid())
-  workspaceId      String
-  workspace        Workspace     @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
-  name             String?
-  workflow         String        // "explore", "implement", "test"
-  model            String        @default("sonnet")
-  status           SessionStatus @default(IDLE)
-  claudeSessionId  String?       // For resume
-  claudeProjectPath String?      // Persisted ~/.claude/projects/<escaped-path> for history lookup
-  claudeProcessPid Int?
-  createdAt        DateTime      @default(now())
-  updatedAt        DateTime      @updatedAt
+model AgentSession {
+  id                  String        @id @default(cuid())
+  workspaceId         String
+  workspace           Workspace     @relation(fields: [workspaceId], references: [id], onDelete: Cascade)
+  name                String?
+  workflow            String // "explore", "implement", "test"
+  model               String        @default("sonnet")
+  status              SessionStatus @default(IDLE)
+  provider            SessionProvider
+  providerSessionId   String?
+  providerProjectPath String?
+  providerProcessPid  Int?
+  providerMetadata    Json?
+  createdAt           DateTime      @default(now())
+  updatedAt           DateTime      @updatedAt
 
   @@index([workspaceId])
   @@index([status])
+  @@index([provider])
+  @@index([workspaceId, provider])
 }
 
 model TerminalSession {
@@ -244,6 +261,7 @@ model UserSettings {
 
   // Ratchet Settings (unified PR progression)
   ratchetEnabled            Boolean  @default(false)  // Default for new GitHub-issue-created workspaces
+  defaultSessionProvider    SessionProvider @default(CLAUDE)
 
   createdAt             DateTime @default(now())
   updatedAt             DateTime @updatedAt

package/prompts/quick-actions/screenshots.md

@@ -0,0 +1,21 @@
+---
+name: Take Screenshots
+description: Capture screenshots of the running dev app
+type: agent
+icon: camera
+---
+Take a screenshot of the workspace's running development app to capture the current state of the UI.
+
+## Step 1: Start the dev server
+
+1. Read `factory-factory.json` in the repo root for the `scripts.run` command
+2. Pick a free port and replace `{port}` in the command with it
+3. Start the dev server in the background and wait for it to be ready
+
+## Step 2: Take a screenshot
+
+1. `mkdir -p .factory-factory/screenshots`
+2. Use `browser_navigate` to visit the dev server URL
+3. Determine the most relevant screen that captures the current state of the app
+4. Use `browser_screenshot` to capture it
+5. Save to `.factory-factory/screenshots/` with a descriptive PNG filename

package/prompts/workflows/bugfix.md

@@ -40,7 +40,19 @@ You are fixing a bug. Follow this workflow to ensure the fix is correct and does
 - Run `pnpm check:fix` to fix linting issues
 - Ensure the build passes
 
-### 7. Create Pull Request
+### 7. Capture UI Screenshots (if applicable)
+
+If your changes affect the UI:
+
+1. Read `factory-factory.json` for the `scripts.run` command, pick a free port, replace `{port}`, and start it in the background.
+2. Use `browser_navigate` to visit the dev server URL
+3. Determine the most relevant screen showing your changes and capture a screenshot
+4. Save screenshots to `.factory-factory/screenshots/` with descriptive names
+5. Commit the screenshots
+6. Reference them in the PR body using raw GitHub URLs:
+   `![Description](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/.factory-factory/screenshots/filename.png)`
+
+### 8. Create Pull Request
 - Commit with a descriptive message referencing the bug
 - Push your branch: `git push -u origin HEAD`
 - Create the PR using the GitHub CLI with a body file to preserve formatting:

package/prompts/workflows/feature.md

@@ -37,7 +37,19 @@ You are implementing a new feature. Follow this workflow to deliver high-quality
 - Run `pnpm check:fix` to fix linting issues
 - Ensure the build passes (`pnpm build:all`)
 
-### 6. Create Pull Request
+### 6. Capture UI Screenshots (if applicable)
+
+If your changes affect the UI:
+
+1. Read `factory-factory.json` for the `scripts.run` command, pick a free port, replace `{port}`, and start it in the background.
+2. Use `browser_navigate` to visit the dev server URL
+3. Determine the most relevant screen showing your changes and capture a screenshot
+4. Save screenshots to `.factory-factory/screenshots/` with descriptive names
+5. Commit the screenshots
+6. Reference them in the PR body using raw GitHub URLs:
+   `![Description](https://raw.githubusercontent.com/{owner}/{repo}/{branch}/.factory-factory/screenshots/filename.png)`
+
+### 7. Create Pull Request
 - Commit all changes with descriptive messages
 - Push your branch: `git push -u origin HEAD`
 - Create the PR using the GitHub CLI with a body file to preserve formatting:

package/dist/client/assets/channel-ClmwMKLM.js

@@ -1 +0,0 @@
-import{ap as o,aq as n}from"./index-CRmN2i75.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};

package/dist/client/assets/classDiagram-2ON5EDUG-eWjFrD1A.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-B4BG7PRW-Dasu1lEb.js";import{_ as i}from"./index-CRmN2i75.js";import"./chunk-FMBD7UC4-ugfv5fjr.js";import"./chunk-55IACEB6-BArXw_yn.js";import"./chunk-QN33PNHL-Fy8ucaTL.js";var p={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{p as diagram};

package/dist/client/assets/classDiagram-v2-WZHVMYZB-eWjFrD1A.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-B4BG7PRW-Dasu1lEb.js";import{_ as i}from"./index-CRmN2i75.js";import"./chunk-FMBD7UC4-ugfv5fjr.js";import"./chunk-55IACEB6-BArXw_yn.js";import"./chunk-QN33PNHL-Fy8ucaTL.js";var p={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{p as diagram};

package/dist/client/assets/clone-CXwSvl4E.js

@@ -1 +0,0 @@
-import{b as r}from"./_baseUniq-5DitBjx0.js";var e=4;function a(o){return r(o,e)}export{a as c};