factory-factory 0.2.8 → 0.3.1

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.1",
+  "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",
@@ -33,44 +34,52 @@
   },
   "files": [
     "dist",
+    "packages/core/package.json",
+    "packages/core/dist",
     "prisma/migrations",
     "prisma/schema.prisma",
     "prompts",
     "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": "file:packages/core",
     "@hookform/resolvers": "^5.2.2",
     "@prisma/adapter-better-sqlite3": "^7.3.0",
     "@prisma/client": "^7.3.0",
@@ -109,6 +118,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 +148,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/packages/core/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type CiVisualState, deriveCiVisualStateFromChecks, deriveCiVisualStateFromPrCiStatus, getCiVisualLabel, } from './shared/ci-status.js';
+export { deriveWorkspaceSidebarStatus, getWorkspaceActivityTooltip, getWorkspaceCiLabel, getWorkspaceCiTooltip, getWorkspacePrTooltipSuffix, type WorkspaceSidebarActivityState, type WorkspaceSidebarCiState, type WorkspaceSidebarStatus, type WorkspaceSidebarStatusInput, } from './shared/workspace-sidebar-status.js';
+export { CIStatus, KanbanColumn, PRState, RatchetState, RunScriptStatus, SessionStatus, WorkspaceCreationSource, WorkspaceStatus, } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,aAAa,EAClB,6BAA6B,EAC7B,iCAAiC,EACjC,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,GACjC,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/packages/core/dist/index.js

@@ -0,0 +1,8 @@
+// @factory-factory/core
+// Core library for Factory Factory workspace execution primitives.
+// Shared utilities
+export { deriveCiVisualStateFromChecks, deriveCiVisualStateFromPrCiStatus, getCiVisualLabel, } from './shared/ci-status.js';
+export { deriveWorkspaceSidebarStatus, getWorkspaceActivityTooltip, getWorkspaceCiLabel, getWorkspaceCiTooltip, getWorkspacePrTooltipSuffix, } from './shared/workspace-sidebar-status.js';
+// Types & Enums
+export { CIStatus, KanbanColumn, PRState, RatchetState, RunScriptStatus, SessionStatus, WorkspaceCreationSource, WorkspaceStatus, } from './types/index.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,mEAAmE;AAEnE,mBAAmB;AACnB,OAAO,EAEL,6BAA6B,EAC7B,iCAAiC,EACjC,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,GAK5B,MAAM,sCAAsC,CAAC;AAC9C,gBAAgB;AAChB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/{dist/src → packages/core/dist}/shared/ci-status.d.ts

@@ -1,8 +1,10 @@
-import type { CIStatus as WorkspaceCiStatus } from '../../prisma/generated/browser.js';
-import type { GitHubStatusCheck } from './github-types.js';
+import type { CIStatus } from '../types/enums.js';
 export type CiVisualState = 'PASSING' | 'FAILING' | 'RUNNING' | 'UNKNOWN' | 'NONE';
-type CheckLike = Pick<GitHubStatusCheck, 'conclusion' | 'status'>;
-export declare function deriveCiVisualStateFromPrCiStatus(status: WorkspaceCiStatus | null | undefined): CiVisualState;
+interface CheckLike {
+    conclusion: string | null;
+    status: string;
+}
+export declare function deriveCiVisualStateFromPrCiStatus(status: CIStatus | null | undefined): CiVisualState;
 export declare function deriveCiVisualStateFromChecks(checks: CheckLike[] | null | undefined): CiVisualState;
 export declare function getCiVisualLabel(state: CiVisualState): string;
 export {};

package/packages/core/dist/shared/ci-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-status.d.ts","sourceRoot":"","sources":["../../src/shared/ci-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnF,UAAU,SAAS;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAClC,aAAa,CAcf;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,GACrC,aAAa,CAkBf;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAa7D"}

package/packages/core/dist/shared/ci-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-status.js","sourceRoot":"","sources":["../../src/shared/ci-status.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,iCAAiC,CAC/C,MAAmC;IAEnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,MAAsC;IAEtC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC;IAC1E,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAC5B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CACrE,CAAC;IACF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC"}

package/packages/core/dist/shared/workspace-sidebar-status.d.ts

@@ -0,0 +1,20 @@
+import type { CIStatus, PRState, RatchetState } from '../types/enums.js';
+export type WorkspaceSidebarActivityState = 'WORKING' | 'IDLE';
+export type WorkspaceSidebarCiState = 'NONE' | 'RUNNING' | 'FAILING' | 'PASSING' | 'UNKNOWN' | 'MERGED';
+export interface WorkspaceSidebarStatus {
+    activityState: WorkspaceSidebarActivityState;
+    ciState: WorkspaceSidebarCiState;
+}
+export interface WorkspaceSidebarStatusInput {
+    isWorking: boolean;
+    prUrl: string | null;
+    prState: PRState | null;
+    prCiStatus: CIStatus | null;
+    ratchetState: RatchetState | null;
+}
+export declare function deriveWorkspaceSidebarStatus(input: WorkspaceSidebarStatusInput): WorkspaceSidebarStatus;
+export declare function getWorkspaceActivityTooltip(state: WorkspaceSidebarActivityState): string;
+export declare function getWorkspaceCiLabel(state: WorkspaceSidebarCiState): string;
+export declare function getWorkspaceCiTooltip(ciState: WorkspaceSidebarCiState, prState: PRState | null): string;
+export declare function getWorkspacePrTooltipSuffix(ciState: WorkspaceSidebarCiState, prState: PRState | null): string;
+//# sourceMappingURL=workspace-sidebar-status.d.ts.map

package/packages/core/dist/shared/workspace-sidebar-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-sidebar-status.d.ts","sourceRoot":"","sources":["../../src/shared/workspace-sidebar-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzE,MAAM,MAAM,6BAA6B,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,6BAA6B,CAAC;IAC7C,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CAuBxB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM,CAExF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAe1E;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,OAAO,GAAG,IAAI,GACtB,MAAM,CAiBR;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,OAAO,GAAG,IAAI,GACtB,MAAM,CAiBR"}

package/packages/core/dist/shared/workspace-sidebar-status.js

@@ -0,0 +1,76 @@
+import { deriveCiVisualStateFromPrCiStatus } from './ci-status.js';
+export function deriveWorkspaceSidebarStatus(input) {
+    const activityState = input.isWorking ? 'WORKING' : 'IDLE';
+    if (!input.prUrl) {
+        return { activityState, ciState: 'NONE' };
+    }
+    if (input.prState === 'MERGED' || input.ratchetState === 'MERGED') {
+        return { activityState, ciState: 'MERGED' };
+    }
+    const ciStateFromSnapshot = deriveCiVisualStateFromPrCiStatus(input.prCiStatus);
+    if (ciStateFromSnapshot === 'UNKNOWN') {
+        if (input.ratchetState === 'CI_FAILED') {
+            return { activityState, ciState: 'FAILING' };
+        }
+        if (input.ratchetState === 'CI_RUNNING') {
+            return { activityState, ciState: 'RUNNING' };
+        }
+    }
+    return { activityState, ciState: ciStateFromSnapshot };
+}
+export function getWorkspaceActivityTooltip(state) {
+    return state === 'WORKING' ? 'Claude is working' : 'Claude is idle';
+}
+export function getWorkspaceCiLabel(state) {
+    switch (state) {
+        case 'NONE':
+            return 'No PR';
+        case 'RUNNING':
+            return 'CI Running';
+        case 'FAILING':
+            return 'CI Failing';
+        case 'PASSING':
+            return 'CI Passing';
+        case 'UNKNOWN':
+            return 'CI Unknown';
+        case 'MERGED':
+            return 'Merged';
+    }
+}
+export function getWorkspaceCiTooltip(ciState, prState) {
+    if (ciState === 'RUNNING') {
+        return 'CI checks are running';
+    }
+    if (ciState === 'FAILING') {
+        return 'CI checks are failing';
+    }
+    if (ciState === 'PASSING') {
+        return 'CI checks are passing';
+    }
+    if (ciState === 'MERGED') {
+        return 'PR is merged';
+    }
+    if (ciState === 'UNKNOWN') {
+        return prState === 'CLOSED' ? 'PR is closed' : 'CI status is unknown';
+    }
+    return 'No PR attached';
+}
+export function getWorkspacePrTooltipSuffix(ciState, prState) {
+    if (prState === 'CLOSED') {
+        return ' · Closed';
+    }
+    if (ciState === 'MERGED') {
+        return ' · Merged';
+    }
+    if (ciState === 'FAILING') {
+        return ' · CI failing';
+    }
+    if (ciState === 'RUNNING') {
+        return ' · CI running';
+    }
+    if (ciState === 'PASSING') {
+        return ' · CI passing';
+    }
+    return '';
+}
+//# sourceMappingURL=workspace-sidebar-status.js.map

package/packages/core/dist/shared/workspace-sidebar-status.js.map

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

package/packages/core/dist/types/enums.d.ts

@@ -0,0 +1,64 @@
+export declare const WorkspaceStatus: {
+    readonly NEW: "NEW";
+    readonly PROVISIONING: "PROVISIONING";
+    readonly READY: "READY";
+    readonly FAILED: "FAILED";
+    readonly ARCHIVED: "ARCHIVED";
+};
+export type WorkspaceStatus = (typeof WorkspaceStatus)[keyof typeof WorkspaceStatus];
+export declare const SessionStatus: {
+    readonly IDLE: "IDLE";
+    readonly RUNNING: "RUNNING";
+    readonly PAUSED: "PAUSED";
+    readonly COMPLETED: "COMPLETED";
+    readonly FAILED: "FAILED";
+};
+export type SessionStatus = (typeof SessionStatus)[keyof typeof SessionStatus];
+export declare const PRState: {
+    readonly NONE: "NONE";
+    readonly DRAFT: "DRAFT";
+    readonly OPEN: "OPEN";
+    readonly CHANGES_REQUESTED: "CHANGES_REQUESTED";
+    readonly APPROVED: "APPROVED";
+    readonly MERGED: "MERGED";
+    readonly CLOSED: "CLOSED";
+};
+export type PRState = (typeof PRState)[keyof typeof PRState];
+export declare const CIStatus: {
+    readonly UNKNOWN: "UNKNOWN";
+    readonly PENDING: "PENDING";
+    readonly SUCCESS: "SUCCESS";
+    readonly FAILURE: "FAILURE";
+};
+export type CIStatus = (typeof CIStatus)[keyof typeof CIStatus];
+export declare const KanbanColumn: {
+    readonly WORKING: "WORKING";
+    readonly WAITING: "WAITING";
+    readonly DONE: "DONE";
+};
+export type KanbanColumn = (typeof KanbanColumn)[keyof typeof KanbanColumn];
+export declare const RatchetState: {
+    readonly IDLE: "IDLE";
+    readonly CI_RUNNING: "CI_RUNNING";
+    readonly CI_FAILED: "CI_FAILED";
+    readonly REVIEW_PENDING: "REVIEW_PENDING";
+    readonly READY: "READY";
+    readonly MERGED: "MERGED";
+};
+export type RatchetState = (typeof RatchetState)[keyof typeof RatchetState];
+export declare const WorkspaceCreationSource: {
+    readonly MANUAL: "MANUAL";
+    readonly RESUME_BRANCH: "RESUME_BRANCH";
+    readonly GITHUB_ISSUE: "GITHUB_ISSUE";
+};
+export type WorkspaceCreationSource = (typeof WorkspaceCreationSource)[keyof typeof WorkspaceCreationSource];
+export declare const RunScriptStatus: {
+    readonly IDLE: "IDLE";
+    readonly STARTING: "STARTING";
+    readonly RUNNING: "RUNNING";
+    readonly STOPPING: "STOPPING";
+    readonly COMPLETED: "COMPLETED";
+    readonly FAILED: "FAILED";
+};
+export type RunScriptStatus = (typeof RunScriptStatus)[keyof typeof RunScriptStatus];
+//# sourceMappingURL=enums.d.ts.map

package/packages/core/dist/types/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAErF,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,eAAO,MAAM,OAAO;;;;;;;;CAQV,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE7D,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E,eAAO,MAAM,uBAAuB;;;;CAI1B,CAAC;AACX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC;AAEzE,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/packages/core/dist/types/enums.js

@@ -0,0 +1,56 @@
+export const WorkspaceStatus = {
+    NEW: 'NEW',
+    PROVISIONING: 'PROVISIONING',
+    READY: 'READY',
+    FAILED: 'FAILED',
+    ARCHIVED: 'ARCHIVED',
+};
+export const SessionStatus = {
+    IDLE: 'IDLE',
+    RUNNING: 'RUNNING',
+    PAUSED: 'PAUSED',
+    COMPLETED: 'COMPLETED',
+    FAILED: 'FAILED',
+};
+export const PRState = {
+    NONE: 'NONE',
+    DRAFT: 'DRAFT',
+    OPEN: 'OPEN',
+    CHANGES_REQUESTED: 'CHANGES_REQUESTED',
+    APPROVED: 'APPROVED',
+    MERGED: 'MERGED',
+    CLOSED: 'CLOSED',
+};
+export const CIStatus = {
+    UNKNOWN: 'UNKNOWN',
+    PENDING: 'PENDING',
+    SUCCESS: 'SUCCESS',
+    FAILURE: 'FAILURE',
+};
+export const KanbanColumn = {
+    WORKING: 'WORKING',
+    WAITING: 'WAITING',
+    DONE: 'DONE',
+};
+export const RatchetState = {
+    IDLE: 'IDLE',
+    CI_RUNNING: 'CI_RUNNING',
+    CI_FAILED: 'CI_FAILED',
+    REVIEW_PENDING: 'REVIEW_PENDING',
+    READY: 'READY',
+    MERGED: 'MERGED',
+};
+export const WorkspaceCreationSource = {
+    MANUAL: 'MANUAL',
+    RESUME_BRANCH: 'RESUME_BRANCH',
+    GITHUB_ISSUE: 'GITHUB_ISSUE',
+};
+export const RunScriptStatus = {
+    IDLE: 'IDLE',
+    STARTING: 'STARTING',
+    RUNNING: 'RUNNING',
+    STOPPING: 'STOPPING',
+    COMPLETED: 'COMPLETED',
+    FAILED: 'FAILED',
+};
+//# sourceMappingURL=enums.js.map

package/packages/core/dist/types/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,KAAK;IACV,YAAY,EAAE,cAAc;IAC5B,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAGX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAC;AAGX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,iBAAiB,EAAE,mBAAmB;IACtC,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAGX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAGX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAGX,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,QAAQ;IAChB,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;CACpB,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/packages/core/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export { CIStatus, KanbanColumn, PRState, RatchetState, RunScriptStatus, SessionStatus, WorkspaceCreationSource, WorkspaceStatus, } from './enums.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/core/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/packages/core/dist/types/index.js

@@ -0,0 +1,2 @@
+export { CIStatus, KanbanColumn, PRState, RatchetState, RunScriptStatus, SessionStatus, WorkspaceCreationSource, WorkspaceStatus, } from './enums.js';
+//# sourceMappingURL=index.js.map

package/packages/core/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/packages/core/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@factory-factory/core",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

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