@adaptware/eagles-db 0.5.39 → 0.5.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptware/eagles-db",
-  "version": "0.5.39",
+  "version": "0.5.41",
   "description": "A Prisma client package for Treadspace database operations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/prisma/schema/applications.prisma

@@ -38,44 +38,40 @@ enum ApplicationOfferSubstatus {
 
 model Application {
   /// Primary key
-  id                            String                     @id @default(uuid())
+  id                        String                   @id @default(uuid())
   /// Foreign keys
-  organisation_id               String
-  candidate_id                  String
-  resume_id                     String
-  job_description_id            String
-  evaluation_plan_id            String?
-  recruiter_id                  String?
-  source_id                     String?
+  organisation_id           String
+  candidate_id              String
+  resume_id                 String
+  job_description_id        String
+  evaluation_plan_id        String?
+  recruiter_id              String?
+  source_id                 String?
   /// Data fields
-  fit_check_score               Float?
-  applied_at                    DateTime                   @default(now())
-  round_no                      Int                        @default(0)
-  is_jaf_completed              Boolean                    @default(false)
-  proceed_to_next_round         Boolean?                   @default(false)
-  evaluationComment             String?
+  fit_check_score           Float?
+  applied_at                DateTime                 @default(now())
+  round_no                  Int                      @default(0)
+  is_jaf_completed          Boolean                  @default(false)
+  proceed_to_next_round     Boolean?                 @default(false)
+  evaluationComment         String?
   /// Candidate flag (orthogonal to ApplicationStatus). Latest actor/comment only.
-  is_flagged                    Boolean                    @default(false)
-  flag_comment                  String?
-  flagged_at                    DateTime?
-  flagged_by                    String?
-  unflag_comment                String?
-  unflagged_at                  DateTime?
-  unflagged_by                  String?
-  fit_check_status              FitCheckStatus?
-  status                        ApplicationStatus          @default(PENDING)
+  is_flagged                Boolean                  @default(false)
+  flag_comment              String?
+  flagged_at                DateTime?
+  flagged_by                String?
+  unflag_comment            String?
+  unflagged_at              DateTime?
+  unflagged_by              String?
+  fit_check_status          FitCheckStatus?
+  status                    ApplicationStatus        @default(PENDING)
   /// Fine-grained offer-stage state. Meaningful only when status = OFFER (or was OFFER for a terminal-substatus that flipped to REJECTED / JOINED).
-  offer_substatus               ApplicationOfferSubstatus?
+  offer_substatus           ApplicationOfferSubstatus?
   /// Audit fields
-  created_at                    DateTime                   @default(now())
-  updated_at                    DateTime                   @updatedAt
-  created_by                    String
-  updated_by                    String
-  is_active                     Boolean                    @default(true)
-  fit_check_report_document_id  String?                    @unique
-  fit_check_report_updated_flag Boolean                    @default(false)
-  fit_check_report_data         Json?                      @default("{}")
-
+  created_at                DateTime                 @default(now())
+  updated_at                DateTime                 @updatedAt
+  created_by                String
+  updated_by                String
+  is_active                 Boolean                  @default(true)
   /// Relations
   evaluation_plan           EvaluationPlan?          @relation(fields: [evaluation_plan_id], references: [id])
   candidate                 User                     @relation(fields: [candidate_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
@@ -94,7 +90,6 @@ model Application {
   communication_messages    CommunicationMessage[]
   job_application_responses JobApplicationResponse[]
   offer                     Offer?
-  fit_check_report_document Document?                @relation("ApplicationFitCheckReportDocument", fields: [fit_check_report_document_id], references: [id], onDelete: SetNull)
 
   @@unique([candidate_id, job_description_id]) // Ensures candidate applies only once per job
   @@index([candidate_id])

package/prisma/schema/assessmentLibrary.prisma

@@ -12,6 +12,8 @@ model AssessmentLibrary {
   created_by       String
   updated_by       String
   is_active        Boolean          @default(true)
+  /// Frozen question plan, batch cursor, and bank-generation status (JSON).
+  generation_state Json?
   organisation     Organisation     @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   questions        Question[] // One assessment → many questions
   assessments      Assessment[]

package/prisma/schema/document.prisma

@@ -37,7 +37,6 @@ model Document {
     offer_letters                   OfferLetter[]            @relation("OfferLetterPdf")
     offer_letter_template_snapshots OfferLetter[]            @relation("OfferLetterTemplateSnapshot")
     offer_draft_edited_html         Offer[]                  @relation("OfferDraftEditedHtml")
-    application_fit_check_report    Application?             @relation("ApplicationFitCheckReportDocument")
 
     // Indexes
     @@index([candidate_id])

package/prisma/schema/evaluationPlan.prisma

@@ -1,5 +1,14 @@
+/// MCQ / interview round classification on EvaluationPlan and analytics.
+/// ASSESSMENT is the legacy value kept for backward compatibility — do not drop it.
+/// GENERAL_APTITUDE_ASSESSMENT and DOMAIN_KNOWLEDGE_ASSESSMENT are explicit split
+/// types for new aptitude vs domain-knowledge MCQ rounds only.
 enum RoundType {
+  /// Legacy MCQ round type; existing plans and analytics may still use this.
   ASSESSMENT
+  /// New explicit general-aptitude MCQ round.
+  GENERAL_APTITUDE_ASSESSMENT
+  /// New explicit domain-knowledge MCQ round.
+  DOMAIN_KNOWLEDGE_ASSESSMENT
   INTERVIEW
   ASSIGNMENT
   SCREENING

package/prisma/schema/migrations/20260522120000_ongoing_evaluation_record_kind/migration.sql

@@ -0,0 +1,25 @@
+-- Safe to re-run: adds record_kind without breaking existing ongoing evaluations.
+
+DO $$ BEGIN
+  CREATE TYPE "OngoingEvaluationRecordKind" AS ENUM (
+    'AI_RECOMMENDED',
+    'PLAN_SELECTED',
+    'COMMITTED'
+  );
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;
+
+ALTER TABLE "OngoingEvaluation"
+  ADD COLUMN IF NOT EXISTS "record_kind" "OngoingEvaluationRecordKind";
+
+ALTER TABLE "OngoingEvaluation"
+  ALTER COLUMN "evaluation_plan_id" DROP NOT NULL;
+
+-- All existing rows are real pipeline rounds — not pre-Proceed drafts.
+UPDATE "OngoingEvaluation"
+SET "record_kind" = 'COMMITTED'
+WHERE "record_kind" IS NULL;
+
+CREATE INDEX IF NOT EXISTS "OngoingEvaluation_application_id_record_kind_idx"
+  ON "OngoingEvaluation"("application_id", "record_kind");

package/prisma/schema/migrations/20260523120000_replace_record_kind_with_is_committed/migration.sql

@@ -0,0 +1,24 @@
+-- Replace record_kind enum with is_committed (null = legacy, false = draft, true = committed).
+
+ALTER TABLE "OngoingEvaluation"
+  ADD COLUMN IF NOT EXISTS "is_committed" BOOLEAN;
+
+UPDATE "OngoingEvaluation"
+SET "is_committed" = false
+WHERE "record_kind" IN ('AI_RECOMMENDED', 'PLAN_SELECTED');
+
+UPDATE "OngoingEvaluation"
+SET "is_committed" = true
+WHERE "record_kind" = 'COMMITTED';
+
+-- Legacy rows without record_kind stay null (treated as committed in app queries).
+
+DROP INDEX IF EXISTS "OngoingEvaluation_application_id_record_kind_idx";
+
+ALTER TABLE "OngoingEvaluation"
+  DROP COLUMN IF EXISTS "record_kind";
+
+DROP TYPE IF EXISTS "OngoingEvaluationRecordKind";
+
+CREATE INDEX IF NOT EXISTS "OngoingEvaluation_application_id_is_committed_idx"
+  ON "OngoingEvaluation"("application_id", "is_committed");

package/prisma/schema/migrations/20260528120000_drop_job_description_recommendation_config/migration.sql

@@ -0,0 +1,2 @@
+-- Drop unused per-job AI recommendation threshold storage (defaults live in application code).
+ALTER TABLE "JobDescription" DROP COLUMN IF EXISTS "recommendation_config";

package/prisma/schema/migrations/20260710120000_add_resume_rendered_export_fields/migration.sql

@@ -0,0 +1,9 @@
+-- AlterTable
+ALTER TABLE "Resume" ADD COLUMN "rendered_export_document_id" TEXT,
+ADD COLUMN "resume_template_id" TEXT;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Resume_rendered_export_document_id_key" ON "Resume"("rendered_export_document_id");
+
+-- AddForeignKey
+ALTER TABLE "Resume" ADD CONSTRAINT "Resume_rendered_export_document_id_fkey" FOREIGN KEY ("rendered_export_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260714120000_add_job_description_display_html_document/migration.sql

@@ -0,0 +1,8 @@
+-- AlterTable
+ALTER TABLE "JobDescription" ADD COLUMN "display_html_document_id" TEXT;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "JobDescription_display_html_document_id_key" ON "JobDescription"("display_html_document_id");
+
+-- AddForeignKey
+ALTER TABLE "JobDescription" ADD CONSTRAINT "JobDescription_display_html_document_id_fkey" FOREIGN KEY ("display_html_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260716120000_add_offer_letters/migration.sql

@@ -0,0 +1,183 @@
+-- CreateEnum
+CREATE TYPE "OfferSubstatus" AS ENUM ('OFFER_CREATED', 'OFFER_SENT', 'VIEWED', 'CHANGE_REQUESTED', 'ACCEPTED', 'DECLINED', 'EXPIRED', 'WITHDRAWN', 'JOINED');
+
+-- CreateEnum
+CREATE TYPE "OfferLetterTemplateScope" AS ENUM ('ORGANIZATION', 'JOB');
+
+-- CreateEnum
+CREATE TYPE "OfferChangeCategory" AS ENUM ('BUDGET', 'BENEFITS', 'JOINING_DATE', 'ROLE_TITLE', 'LOCATION', 'OTHER');
+
+-- CreateEnum
+CREATE TYPE "OfferChangeRequestStatus" AS ENUM ('OPEN', 'ADDRESSED');
+
+-- AlterTable
+ALTER TABLE "Application" ADD COLUMN "offer_substatus" "OfferSubstatus";
+
+-- CreateTable
+CREATE TABLE "OfferLetterTemplate" (
+    "id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "job_description_id" TEXT,
+    "name" TEXT NOT NULL,
+    "description" TEXT,
+    "document_id" TEXT NOT NULL,
+    "html_document_id" TEXT,
+    "scope" "OfferLetterTemplateScope" NOT NULL DEFAULT 'ORGANIZATION',
+    "is_default" BOOLEAN NOT NULL DEFAULT false,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferLetterTemplate_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Offer" (
+    "id" TEXT NOT NULL,
+    "application_id" TEXT NOT NULL,
+    "organisation_id" TEXT NOT NULL,
+    "candidate_id" TEXT NOT NULL,
+    "job_description_id" TEXT NOT NULL,
+    "template_id" TEXT,
+    "substatus" "OfferSubstatus" NOT NULL DEFAULT 'OFFER_CREATED',
+    "letter_version_count" INTEGER NOT NULL DEFAULT 0,
+    "change_request_count" INTEGER NOT NULL DEFAULT 0,
+    "terms" JSONB NOT NULL DEFAULT '{}',
+    "expires_at" TIMESTAMP(3),
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Offer_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "OfferLetter" (
+    "id" TEXT NOT NULL,
+    "offer_id" TEXT NOT NULL,
+    "version" INTEGER NOT NULL,
+    "document_id" TEXT NOT NULL,
+    "template_id" TEXT,
+    "template_document_id" TEXT,
+    "sent_at" TIMESTAMP(3),
+    "viewed_at" TIMESTAMP(3),
+    "change_request_note" TEXT,
+    "is_active" BOOLEAN NOT NULL DEFAULT true,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferLetter_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "OfferChangeRequest" (
+    "id" TEXT NOT NULL,
+    "offer_id" TEXT NOT NULL,
+    "offer_letter_id" TEXT NOT NULL,
+    "categories" "OfferChangeCategory"[],
+    "note" TEXT,
+    "status" "OfferChangeRequestStatus" NOT NULL DEFAULT 'OPEN',
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferChangeRequest_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_organisation_id_scope_idx" ON "OfferLetterTemplate"("organisation_id", "scope");
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_job_description_id_idx" ON "OfferLetterTemplate"("job_description_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_document_id_idx" ON "OfferLetterTemplate"("document_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_html_document_id_idx" ON "OfferLetterTemplate"("html_document_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Offer_application_id_key" ON "Offer"("application_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_organisation_id_idx" ON "Offer"("organisation_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_candidate_id_idx" ON "Offer"("candidate_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_job_description_id_idx" ON "Offer"("job_description_id");
+
+-- CreateIndex
+CREATE INDEX "Offer_substatus_idx" ON "Offer"("substatus");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "OfferLetter_document_id_key" ON "OfferLetter"("document_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetter_offer_id_idx" ON "OfferLetter"("offer_id");
+
+-- CreateIndex
+CREATE INDEX "OfferLetter_template_id_idx" ON "OfferLetter"("template_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "OfferLetter_offer_id_version_key" ON "OfferLetter"("offer_id", "version");
+
+-- CreateIndex
+CREATE INDEX "OfferChangeRequest_offer_id_status_idx" ON "OfferChangeRequest"("offer_id", "status");
+
+-- CreateIndex
+CREATE INDEX "OfferChangeRequest_offer_letter_id_idx" ON "OfferChangeRequest"("offer_letter_id");
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_job_description_id_fkey" FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_document_id_fkey" FOREIGN KEY ("document_id") REFERENCES "Document"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetterTemplate" ADD CONSTRAINT "OfferLetterTemplate_html_document_id_fkey" FOREIGN KEY ("html_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_application_id_fkey" FOREIGN KEY ("application_id") REFERENCES "Application"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_organisation_id_fkey" FOREIGN KEY ("organisation_id") REFERENCES "Organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_candidate_id_fkey" FOREIGN KEY ("candidate_id") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_job_description_id_fkey" FOREIGN KEY ("job_description_id") REFERENCES "JobDescription"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_template_id_fkey" FOREIGN KEY ("template_id") REFERENCES "OfferLetterTemplate"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_offer_id_fkey" FOREIGN KEY ("offer_id") REFERENCES "Offer"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_document_id_fkey" FOREIGN KEY ("document_id") REFERENCES "Document"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_template_id_fkey" FOREIGN KEY ("template_id") REFERENCES "OfferLetterTemplate"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferLetter" ADD CONSTRAINT "OfferLetter_template_document_id_fkey" FOREIGN KEY ("template_document_id") REFERENCES "Document"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferChangeRequest" ADD CONSTRAINT "OfferChangeRequest_offer_id_fkey" FOREIGN KEY ("offer_id") REFERENCES "Offer"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "OfferChangeRequest" ADD CONSTRAINT "OfferChangeRequest_offer_letter_id_fkey" FOREIGN KEY ("offer_letter_id") REFERENCES "OfferLetter"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+

package/prisma/schema/migrations/20260716140000_offer_schema_refinements/migration.sql

@@ -0,0 +1,13 @@
+-- CreateEnum
+CREATE TYPE "WorkMode" AS ENUM ('REMOTE', 'OFFICE', 'HYBRID');
+
+-- AlterEnum
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'IN_PROGRESS';
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'REJECTED';
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'WITHDRAWN';
+ALTER TYPE "OfferChangeRequestStatus" ADD VALUE 'EXPIRED';
+
+-- AlterTable
+ALTER TABLE "OfferChangeRequest" ADD COLUMN "details" JSONB,
+ADD COLUMN "hr_note" TEXT,
+ADD COLUMN "resolved_at" TIMESTAMP(3);

package/prisma/schema/migrations/20260716160000_offer_schema_hardening/migration.sql

@@ -0,0 +1,95 @@
+-- CreateEnum
+CREATE TYPE "OfferLetterStatus" AS ENUM ('ACTIVE', 'SUPERSEDED', 'VOID');
+
+-- CreateEnum
+CREATE TYPE "OfferWithdrawReason" AS ENUM ('ROLE_CLOSED', 'CANDIDATE_ACCEPTED_ELSEWHERE', 'BUDGET', 'MISFIT', 'OTHER');
+
+-- AlterEnum: OfferSubstatus — negotiation substatuses
+ALTER TYPE "OfferSubstatus" ADD VALUE 'CHANGE_UNDER_REVIEW';
+ALTER TYPE "OfferSubstatus" ADD VALUE 'COUNTER_OFFER_SENT';
+
+-- AlterEnum: OfferChangeRequestStatus — ADDRESSED → RESOLVED
+ALTER TYPE "OfferChangeRequestStatus" RENAME VALUE 'ADDRESSED' TO 'RESOLVED';
+
+-- AlterEnum: ActivityEventType — offer workflow events
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CREATED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_SENT';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_VIEWED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_REQUESTED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_UNDER_REVIEW';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_COUNTER_SENT';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_ACCEPTED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_DECLINED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_WITHDRAWN';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_EXPIRED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_JOINED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_REQUEST_REJECTED';
+ALTER TYPE "ActivityEventType" ADD VALUE 'OFFER_CHANGE_REQUEST_WITHDRAWN';
+
+-- AlterEnum: ActivityEntityType — OFFER
+ALTER TYPE "ActivityEntityType" ADD VALUE 'OFFER';
+
+-- AlterTable: OfferLetterTemplate — template version
+ALTER TABLE "OfferLetterTemplate" ADD COLUMN "version" INTEGER NOT NULL DEFAULT 1;
+
+-- AlterTable: Offer — analytics, withdrawal, current letter pointer
+ALTER TABLE "Offer" ADD COLUMN "current_offer_letter_id" TEXT,
+ADD COLUMN "sent_at" TIMESTAMP(3),
+ADD COLUMN "responded_at" TIMESTAMP(3),
+ADD COLUMN "accepted_at" TIMESTAMP(3),
+ADD COLUMN "declined_at" TIMESTAMP(3),
+ADD COLUMN "withdrawn_at" TIMESTAMP(3),
+ADD COLUMN "expired_at" TIMESTAMP(3),
+ADD COLUMN "joined_at" TIMESTAMP(3),
+ADD COLUMN "withdraw_reason" "OfferWithdrawReason",
+ADD COLUMN "withdraw_note" TEXT;
+
+-- AlterTable: OfferLetter — business lifecycle status + template version snapshot
+ALTER TABLE "OfferLetter" ADD COLUMN "status" "OfferLetterStatus" NOT NULL DEFAULT 'ACTIVE',
+ADD COLUMN "template_version" INTEGER;
+
+-- Backfill: letter status — max version ACTIVE, others SUPERSEDED
+UPDATE "OfferLetter" ol
+SET "status" = CASE
+  WHEN ol."version" = (
+    SELECT MAX(ol2."version")
+    FROM "OfferLetter" ol2
+    WHERE ol2."offer_id" = ol."offer_id" AND ol2."is_active" = true
+  ) THEN 'ACTIVE'::"OfferLetterStatus"
+  ELSE 'SUPERSEDED'::"OfferLetterStatus"
+END
+WHERE ol."is_active" = true;
+
+-- Backfill: current_offer_letter_id = latest active letter by version
+UPDATE "Offer" o
+SET "current_offer_letter_id" = (
+  SELECT ol."id"
+  FROM "OfferLetter" ol
+  WHERE ol."offer_id" = o."id" AND ol."is_active" = true
+  ORDER BY ol."version" DESC
+  LIMIT 1
+)
+WHERE EXISTS (
+  SELECT 1 FROM "OfferLetter" ol WHERE ol."offer_id" = o."id" AND ol."is_active" = true
+);
+
+-- Backfill: sent_at from earliest letter sent_at
+UPDATE "Offer" o
+SET "sent_at" = (
+  SELECT MIN(ol."sent_at")
+  FROM "OfferLetter" ol
+  WHERE ol."offer_id" = o."id" AND ol."sent_at" IS NOT NULL
+)
+WHERE o."sent_at" IS NULL
+  AND EXISTS (
+    SELECT 1 FROM "OfferLetter" ol WHERE ol."offer_id" = o."id" AND ol."sent_at" IS NOT NULL
+  );
+
+-- CreateIndex
+CREATE INDEX "Offer_organisation_id_substatus_idx" ON "Offer"("organisation_id", "substatus");
+CREATE INDEX "Offer_expires_at_idx" ON "Offer"("expires_at");
+CREATE INDEX "Offer_current_offer_letter_id_idx" ON "Offer"("current_offer_letter_id");
+CREATE INDEX "OfferLetter_offer_id_status_idx" ON "OfferLetter"("offer_id", "status");
+
+-- AddForeignKey
+ALTER TABLE "Offer" ADD CONSTRAINT "Offer_current_offer_letter_id_fkey" FOREIGN KEY ("current_offer_letter_id") REFERENCES "OfferLetter"("id") ON DELETE SET NULL ON UPDATE CASCADE;

package/prisma/schema/migrations/20260716180000_offer_letter_template_config/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "public"."OfferLetterTemplate" ADD COLUMN "template_config" JSONB NOT NULL DEFAULT '{}';

package/prisma/schema/migrations/20260716190000_add_evaluation_focus_areas/migration.sql

@@ -0,0 +1,6 @@
+-- Add focus_areas alongside legacy topics (backfill copies topics → focus_areas).
+ALTER TABLE "EvaluationPlan"
+ADD COLUMN "focus_areas" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];
+
+ALTER TABLE "OngoingEvaluation"
+ADD COLUMN "focus_areas" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];

package/prisma/schema/migrations/20260717120000_offer_workflow_approval/migration.sql

@@ -0,0 +1,30 @@
+-- AlterEnum
+ALTER TYPE "OfferSubstatus" ADD VALUE 'PENDING_APPROVAL' AFTER 'OFFER_CREATED';
+
+-- CreateEnum
+CREATE TYPE "OfferApprovalStatus" AS ENUM ('PENDING', 'APPROVED', 'REJECTED');
+
+-- CreateTable
+CREATE TABLE "OfferApproval" (
+    "id" TEXT NOT NULL,
+    "offer_id" TEXT NOT NULL,
+    "status" "OfferApprovalStatus" NOT NULL DEFAULT 'PENDING',
+    "note" TEXT,
+    "decided_at" TIMESTAMP(3),
+    "decided_by" TEXT,
+    "created_by" TEXT NOT NULL,
+    "updated_by" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "OfferApproval_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "OfferApproval_offer_id_status_idx" ON "OfferApproval"("offer_id", "status");
+
+-- CreateIndex
+CREATE INDEX "OfferApproval_offer_id_created_at_idx" ON "OfferApproval"("offer_id", "created_at");
+
+-- AddForeignKey
+ALTER TABLE "OfferApproval" ADD CONSTRAINT "OfferApproval_offer_id_fkey" FOREIGN KEY ("offer_id") REFERENCES "Offer"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/schema/migrations/20260720120000_offer_letter_template_is_draft/migration.sql

@@ -0,0 +1,5 @@
+-- AlterTable
+ALTER TABLE "public"."OfferLetterTemplate" ADD COLUMN "is_draft" BOOLEAN NOT NULL DEFAULT false;
+
+-- CreateIndex
+CREATE INDEX "OfferLetterTemplate_job_description_id_is_draft_idx" ON "public"."OfferLetterTemplate"("job_description_id", "is_draft");

package/prisma/schema/migrations/20260720140000_offer_status_split/migration.sql

@@ -0,0 +1,51 @@
+-- CreateEnum
+CREATE TYPE "OfferStatus" AS ENUM ('OPEN', 'ACCEPTED', 'DECLINED', 'EXPIRED', 'WITHDRAWN', 'JOINED', 'NO_SHOW');
+
+-- AlterEnum: ApplicationStatus — offer pipeline stages
+-- Must be committed before OFFER/HIRED are used in UPDATE (see next migration).
+ALTER TYPE "ApplicationStatus" ADD VALUE 'OFFER';
+ALTER TYPE "ApplicationStatus" ADD VALUE 'HIRED';
+
+-- AlterTable: Offer — status + no-show
+ALTER TABLE "Offer" ADD COLUMN "status" "OfferStatus" NOT NULL DEFAULT 'OPEN',
+ADD COLUMN "no_show_at" TIMESTAMP(3);
+
+-- Backfill Offer.status from legacy substatus outcomes
+UPDATE "Offer"
+SET "status" = CASE
+  WHEN "substatus" IN (
+    'OFFER_CREATED',
+    'PENDING_APPROVAL',
+    'OFFER_SENT',
+    'VIEWED',
+    'CHANGE_REQUESTED',
+    'CHANGE_UNDER_REVIEW',
+    'COUNTER_OFFER_SENT'
+  ) THEN 'OPEN'::"OfferStatus"
+  WHEN "substatus" = 'ACCEPTED' THEN 'ACCEPTED'::"OfferStatus"
+  WHEN "substatus" = 'DECLINED' THEN 'DECLINED'::"OfferStatus"
+  WHEN "substatus" = 'EXPIRED' THEN 'EXPIRED'::"OfferStatus"
+  WHEN "substatus" = 'WITHDRAWN' THEN 'WITHDRAWN'::"OfferStatus"
+  WHEN "substatus" = 'JOINED' THEN 'JOINED'::"OfferStatus"
+  ELSE 'OPEN'::"OfferStatus"
+END;
+
+-- Clear substatus for terminal outcomes
+UPDATE "Offer"
+SET "substatus" = NULL
+WHERE "status" IN ('ACCEPTED', 'DECLINED', 'EXPIRED', 'WITHDRAWN', 'JOINED');
+
+ALTER TABLE "Offer" ALTER COLUMN "substatus" DROP DEFAULT;
+ALTER TABLE "Offer" ALTER COLUMN "substatus" DROP NOT NULL;
+
+-- AlterTable: Application — offer_status mirror
+ALTER TABLE "Application" ADD COLUMN "offer_status" "OfferStatus";
+
+-- Backfill Application offer mirrors from active offers
+UPDATE "Application" a
+SET
+  "offer_status" = o."status",
+  "offer_substatus" = o."substatus"
+FROM "Offer" o
+WHERE o."application_id" = a."id"
+  AND o."is_active" = true;

package/prisma/schema/migrations/20260720140001_offer_status_split_backfill/migration.sql

@@ -0,0 +1,37 @@
+-- ApplicationStatus OFFER/HIRED were added in the prior migration; safe to use after commit.
+
+-- Backfill Application pipeline stage
+UPDATE "Application"
+SET "status" = 'HIRED'::"ApplicationStatus"
+WHERE "offer_status" = 'JOINED'::"OfferStatus";
+
+UPDATE "Application"
+SET "status" = 'OFFER'::"ApplicationStatus"
+WHERE "offer_status" IS NOT NULL
+  AND "offer_status" <> 'JOINED'::"OfferStatus";
+
+-- Slim OfferSubstatus: remove terminal values
+CREATE TYPE "OfferSubstatus_new" AS ENUM (
+  'OFFER_CREATED',
+  'PENDING_APPROVAL',
+  'OFFER_SENT',
+  'VIEWED',
+  'CHANGE_REQUESTED',
+  'CHANGE_UNDER_REVIEW',
+  'COUNTER_OFFER_SENT'
+);
+
+ALTER TABLE "Offer"
+  ALTER COLUMN "substatus" TYPE "OfferSubstatus_new"
+  USING ("substatus"::text::"OfferSubstatus_new");
+
+ALTER TABLE "Application"
+  ALTER COLUMN "offer_substatus" TYPE "OfferSubstatus_new"
+  USING ("offer_substatus"::text::"OfferSubstatus_new");
+
+DROP TYPE "OfferSubstatus";
+ALTER TYPE "OfferSubstatus_new" RENAME TO "OfferSubstatus";
+
+-- CreateIndex
+CREATE INDEX "Offer_organisation_id_status_idx" ON "Offer"("organisation_id", "status");
+CREATE INDEX "Offer_status_idx" ON "Offer"("status");

package/prisma/schema/migrations/20260722120000_offer_draft_edited_html/migration.sql

@@ -0,0 +1,13 @@
+-- Offer-scoped draft letter HTML (never mutates OfferLetterTemplate).
+ALTER TABLE "public"."Offer"
+ADD COLUMN "draft_edited_html_document_id" TEXT;
+
+CREATE INDEX "Offer_draft_edited_html_document_id_idx"
+ON "public"."Offer"("draft_edited_html_document_id");
+
+ALTER TABLE "public"."Offer"
+ADD CONSTRAINT "Offer_draft_edited_html_document_id_fkey"
+FOREIGN KEY ("draft_edited_html_document_id")
+REFERENCES "public"."Document"("id")
+ON DELETE SET NULL
+ON UPDATE CASCADE;