@adaptware/eagles-db 0.5.48 → 0.5.50

package/package.json

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

package/prisma/schema/interview.prisma

@@ -27,15 +27,19 @@ enum AiAssistanceMode {
 model Interview {
   id                            String            @id @default(uuid())
   /// Foreign keys
-  organisation_id               String
+  organisation_id               String?
   candidate_id                  String
   interviewer_id                String?
-  evaluation_plan_id            String
+  evaluation_plan_id            String?
   application_id                String?
   resume_id                     String
-  job_description_id            String
+  job_description_id            String?
   calendar_event_id             String?
   calendar_events               Json?
+  /// True for candidate-initiated profile enrichment voice sessions (not hiring).
+  candidate_initiated           Boolean           @default(false)
+  /// Profile AI: purpose, focusAreas, focusAreaCoverage, etc.
+  candidate_interview_metadata  Json?
   /// Data
   room_name                     String?
   /// @deprecated Prefer `ai_feedback.feedback` (narrative string on AI feedback JSON).
@@ -96,9 +100,9 @@ model Interview {
   // Relations
   candidate                 User?              @relation("CandidateInterviews", fields: [candidate_id], references: [id], onDelete: SetNull)
   interviewer               User?              @relation("InterviewerInterviews", fields: [interviewer_id], references: [id], onDelete: SetNull)
-  organisation              Organisation       @relation(fields: [organisation_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  organisation              Organisation?      @relation(fields: [organisation_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   recording_document        Document?          @relation(fields: [recording_document_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
-  job_description           JobDescription     @relation(fields: [job_description_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
+  job_description           JobDescription?    @relation(fields: [job_description_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   resume                    Resume             @relation(fields: [resume_id], references: [id], onDelete: Cascade, onUpdate: Cascade)
   evaluation_plan           EvaluationPlan?    @relation(fields: [evaluation_plan_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   application               Application?       @relation(fields: [application_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
@@ -110,11 +114,12 @@ model Interview {
   zoom_meeting              ZoomMeeting?
 
   // Indexes
-  @@unique([interviewer_id, candidate_id, evaluation_plan_id])
   @@index([candidate_id])
+  @@index([candidate_id, candidate_initiated, created_at])
   @@index([interviewer_id])
   @@index([job_description_id])
   @@index([organisation_id, interview_status])
   @@index([interview_status, scheduled_start_time])
+  @@index([candidate_initiated, interview_status])
   @@schema("public")
 }

package/prisma/schema/licensing/assignmentHistory.prisma

@@ -1,10 +1,12 @@
-/// Immutable assignment history for Hiring Unit department/job changes.
+/// Immutable assignment history for Hiring Unit department/user/job changes.
 model PurchasedHiringUnitAssignmentEvent {
   id                          String                               @id @default(uuid())
   purchased_hiring_unit_id      String
   event_kind                  PurchasedHiringUnitAssignmentEventKind
   previous_department_id      String?
   new_department_id           String?
+  previous_assigned_user_id   String?
+  new_assigned_user_id        String?
   previous_job_description_id String?
   new_job_description_id      String?
   effective_at                DateTime                             @default(now())

package/prisma/schema/licensing/licensingEnums.prisma

@@ -34,6 +34,8 @@ enum PurchasedTopUpStatus {
 enum PurchasedHiringUnitAssignmentEventKind {
   DEPARTMENT_ASSIGNED
   DEPARTMENT_UNASSIGNED
+  USER_ASSIGNED
+  USER_UNASSIGNED
   JOB_LINKED
   JOB_UNLINKED
 

package/prisma/schema/licensing/purchasedLicense.prisma

@@ -41,6 +41,8 @@ model PurchasedHiringUnit {
   status                       PurchasedHiringUnitStatus @default(AVAILABLE)
   /// Current department allocation (licensing allocation, not hiring manager).
   department_id                String?
+  /// Optional person reservation. Units with this set are consumed before dept/org pools.
+  assigned_user_id             String?
   /// Set once when department_id is first assigned; not cleared on reassignment.
   first_assigned_at            DateTime?
   /// Optional unit expiry.
@@ -57,6 +59,7 @@ model PurchasedHiringUnit {
   organisation              Organisation                         @relation(fields: [organisation_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
   purchased_license_package PurchasedLicensePackage              @relation(fields: [purchased_license_package_id], references: [id], onDelete: Restrict, onUpdate: Cascade)
   department                Department?                          @relation(fields: [department_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
+  assigned_user             User?                                @relation("AssignedHiringUnits", fields: [assigned_user_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   job_description           JobDescription?                      @relation(fields: [job_description_id], references: [id], onDelete: SetNull, onUpdate: Cascade)
   assignment_events         PurchasedHiringUnitAssignmentEvent[]
   ledger_entries            LicensingLedgerEntry[]
@@ -65,9 +68,11 @@ model PurchasedHiringUnit {
   @@index([organisation_id])
   @@index([purchased_license_package_id])
   @@index([department_id])
+  @@index([assigned_user_id])
   @@index([job_description_id])
   @@index([organisation_id, status])
   @@index([organisation_id, department_id])
+  @@index([organisation_id, assigned_user_id])
   @@index([organisation_id, job_description_id])
   @@map("purchased_hiring_units")
   @@schema("licensing")

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;

package/prisma/schema/migrations/20260723150000_offer_withdraw_actor_no_show_reason/migration.sql

@@ -0,0 +1,10 @@
+-- CreateEnum
+CREATE TYPE "public"."OfferWithdrawActor" AS ENUM ('CANDIDATE', 'ORGANISATION');
+
+-- CreateEnum
+CREATE TYPE "public"."OfferNoShowReason" AS ENUM ('ACCEPTED_ELSEWHERE', 'OTHER');
+
+-- AlterTable
+ALTER TABLE "public"."Offer"
+ADD COLUMN "withdraw_actor" "public"."OfferWithdrawActor",
+ADD COLUMN "no_show_reason" "public"."OfferNoShowReason";