memorix 1.2.6 → 1.2.8

package/dist/index.js

@@ -234,6 +234,7 @@ function getDatabase(dataDir) {
   db2.exec(CREATE_OBSERVATION_CODE_REFS_TABLE);
   db2.exec(CREATE_MAINTENANCE_JOBS_TABLE);
   db2.exec(CREATE_MAINTENANCE_TARGETS_TABLE);
+  db2.exec(CREATE_COMPACTION_CHECKPOINTS_TABLE);
   try {
     db2.exec(`ALTER TABLE mini_skills ADD COLUMN sourceSnapshot TEXT NOT NULL DEFAULT ''`);
   } catch {
@@ -274,7 +275,7 @@ function getDatabase(dataDir) {
   _dbCache.set(normalized, db2);
   return db2;
 }
-var BetterSqlite3, CREATE_OBSERVATIONS_TABLE, CREATE_MINI_SKILLS_TABLE, CREATE_SESSIONS_TABLE, CREATE_META_TABLE, CREATE_TEAM_AGENTS_TABLE, CREATE_TEAM_MESSAGES_TABLE, CREATE_TEAM_TASKS_TABLE, CREATE_TEAM_TASK_DEPS_TABLE, CREATE_TEAM_LOCKS_TABLE, CREATE_TEAM_ROLES_TABLE, CREATE_CHAT_TRANSCRIPT_TABLE, CREATE_GRAPH_ENTITIES_TABLE, CREATE_GRAPH_RELATIONS_TABLE, CREATE_CODE_FILES_TABLE, CREATE_CODE_SYMBOLS_TABLE, CREATE_CODE_EDGES_TABLE, CREATE_OBSERVATION_CODE_REFS_TABLE, CREATE_SCHEMA_MIGRATIONS_TABLE, CREATE_CODE_STATE_SNAPSHOTS_TABLE, CREATE_KNOWLEDGE_CLAIMS_TABLE, CREATE_KNOWLEDGE_CLAIM_EVIDENCE_TABLE, CREATE_KNOWLEDGE_CLAIM_EVENTS_TABLE, CREATE_KNOWLEDGE_WORKSPACES_TABLE, CREATE_KNOWLEDGE_PAGES_TABLE, CREATE_KNOWLEDGE_PAGE_CLAIMS_TABLE, CREATE_KNOWLEDGE_PAGE_LINKS_TABLE, CREATE_KNOWLEDGE_PROPOSALS_TABLE, CREATE_KNOWLEDGE_WORKFLOWS_TABLE, CREATE_KNOWLEDGE_WORKFLOW_RUNS_TABLE, CREATE_MAINTENANCE_JOBS_TABLE, CREATE_MAINTENANCE_TARGETS_TABLE, CREATE_INDEXES, SCHEMA_MIGRATIONS, _dbCache;
+var BetterSqlite3, CREATE_OBSERVATIONS_TABLE, CREATE_MINI_SKILLS_TABLE, CREATE_SESSIONS_TABLE, CREATE_META_TABLE, CREATE_TEAM_AGENTS_TABLE, CREATE_TEAM_MESSAGES_TABLE, CREATE_TEAM_TASKS_TABLE, CREATE_TEAM_TASK_DEPS_TABLE, CREATE_TEAM_LOCKS_TABLE, CREATE_TEAM_ROLES_TABLE, CREATE_CHAT_TRANSCRIPT_TABLE, CREATE_GRAPH_ENTITIES_TABLE, CREATE_GRAPH_RELATIONS_TABLE, CREATE_CODE_FILES_TABLE, CREATE_CODE_SYMBOLS_TABLE, CREATE_CODE_EDGES_TABLE, CREATE_OBSERVATION_CODE_REFS_TABLE, CREATE_SCHEMA_MIGRATIONS_TABLE, CREATE_CODE_STATE_SNAPSHOTS_TABLE, CREATE_KNOWLEDGE_CLAIMS_TABLE, CREATE_KNOWLEDGE_CLAIM_EVIDENCE_TABLE, CREATE_KNOWLEDGE_CLAIM_EVENTS_TABLE, CREATE_KNOWLEDGE_WORKSPACES_TABLE, CREATE_KNOWLEDGE_PAGES_TABLE, CREATE_KNOWLEDGE_PAGE_CLAIMS_TABLE, CREATE_KNOWLEDGE_PAGE_LINKS_TABLE, CREATE_KNOWLEDGE_PROPOSALS_TABLE, CREATE_KNOWLEDGE_WORKFLOWS_TABLE, CREATE_KNOWLEDGE_WORKFLOW_RUNS_TABLE, CREATE_MAINTENANCE_JOBS_TABLE, CREATE_MAINTENANCE_TARGETS_TABLE, CREATE_COMPACTION_CHECKPOINTS_TABLE, CREATE_INDEXES, SCHEMA_MIGRATIONS, _dbCache;
 var init_sqlite_db = __esm({
   "src/store/sqlite-db.ts"() {
     "use strict";
@@ -726,6 +727,31 @@ CREATE TABLE IF NOT EXISTS maintenance_targets (
   data_dir     TEXT NOT NULL,
   updated_at   INTEGER NOT NULL
 );
+`;
+    CREATE_COMPACTION_CHECKPOINTS_TABLE = `
+CREATE TABLE IF NOT EXISTS compaction_checkpoints (
+  id                   TEXT PRIMARY KEY,
+  project_id           TEXT NOT NULL,
+  session_id           TEXT NOT NULL,
+  agent                TEXT NOT NULL,
+  phase                TEXT NOT NULL,
+  capture_kind         TEXT NOT NULL,
+  reason               TEXT NOT NULL DEFAULT 'unknown',
+  source_event         TEXT NOT NULL,
+  source_key           TEXT NOT NULL,
+  summary              TEXT,
+  tokens_before        INTEGER,
+  first_kept_entry_id  TEXT,
+  details_json         TEXT NOT NULL DEFAULT '{}',
+  transcript_available INTEGER NOT NULL DEFAULT 0,
+  status               TEXT NOT NULL DEFAULT 'active',
+  pre_captured_at      TEXT NOT NULL,
+  completed_at         TEXT,
+  delivered_at         TEXT,
+  delivery_count       INTEGER NOT NULL DEFAULT 0,
+  created_at           TEXT NOT NULL,
+  updated_at           TEXT NOT NULL
+);
 `;
     CREATE_INDEXES = `
 CREATE INDEX IF NOT EXISTS idx_observations_projectId ON observations(projectId);
@@ -773,6 +799,9 @@ CREATE INDEX IF NOT EXISTS idx_knowledge_workflow_runs_project_workflow ON knowl
 CREATE INDEX IF NOT EXISTS idx_maintenance_jobs_ready ON maintenance_jobs(status, run_after);
 CREATE INDEX IF NOT EXISTS idx_maintenance_jobs_project ON maintenance_jobs(project_id, status, run_after);
 CREATE INDEX IF NOT EXISTS idx_maintenance_targets_updated ON maintenance_targets(updated_at);
+CREATE INDEX IF NOT EXISTS idx_compaction_checkpoints_project_recent ON compaction_checkpoints(project_id, status, completed_at DESC, pre_captured_at DESC);
+CREATE INDEX IF NOT EXISTS idx_compaction_checkpoints_session_pending ON compaction_checkpoints(project_id, session_id, agent, phase, status, pre_captured_at DESC);
+CREATE INDEX IF NOT EXISTS idx_compaction_checkpoints_source ON compaction_checkpoints(project_id, source_key);
 CREATE UNIQUE INDEX IF NOT EXISTS idx_maintenance_jobs_active_dedupe
   ON maintenance_jobs(project_id, kind, dedupe_key)
   WHERE status IN ('pending', 'running', 'retry');
@@ -846,6 +875,15 @@ CREATE UNIQUE INDEX IF NOT EXISTS idx_maintenance_jobs_active_dedupe
           db2.exec("CREATE INDEX IF NOT EXISTS idx_knowledge_workflows_workspace_status ON knowledge_workflows(workspaceId, status, updatedAt DESC)");
           db2.exec("CREATE INDEX IF NOT EXISTS idx_knowledge_workflow_runs_project_workflow ON knowledge_workflow_runs(projectId, workflowId, startedAt DESC)");
         }
+      },
+      {
+        id: "1.2.7-compaction-checkpoints",
+        apply: (db2) => {
+          db2.exec(CREATE_COMPACTION_CHECKPOINTS_TABLE);
+          db2.exec("CREATE INDEX IF NOT EXISTS idx_compaction_checkpoints_project_recent ON compaction_checkpoints(project_id, status, completed_at DESC, pre_captured_at DESC)");
+          db2.exec("CREATE INDEX IF NOT EXISTS idx_compaction_checkpoints_session_pending ON compaction_checkpoints(project_id, session_id, agent, phase, status, pre_captured_at DESC)");
+          db2.exec("CREATE INDEX IF NOT EXISTS idx_compaction_checkpoints_source ON compaction_checkpoints(project_id, source_key)");
+        }
       }
     ];
     _dbCache = /* @__PURE__ */ new Map();
@@ -7143,6 +7181,10 @@ var init_maintenance_jobs = __esm({
         LIMIT 1
       `).get(input.projectId, input.kind, dedupeKey);
           if (existing) {
+            if (input.kind === "vector-backfill" && existing.status === "retry") {
+              this.commit();
+              return rowToJob(existing);
+            }
             const nextRunAfter = Math.min(Number(existing.run_after), runAfter);
             this.db.prepare(`
           UPDATE maintenance_jobs
@@ -7153,6 +7195,26 @@ var init_maintenance_jobs = __esm({
             this.commit();
             return rowToJob(updated);
           }
+          if (input.kind === "vector-backfill") {
+            const failed = this.db.prepare(`
+          SELECT * FROM maintenance_jobs
+          WHERE project_id = ? AND kind = ? AND dedupe_key = ? AND status = 'failed'
+          ORDER BY updated_at DESC
+          LIMIT 1
+        `).get(input.projectId, input.kind, dedupeKey);
+            if (failed) {
+              this.db.prepare(`
+            UPDATE maintenance_jobs
+            SET status = 'pending', attempts = 0, max_attempts = ?, run_after = ?,
+                payload_json = ?, lease_owner = NULL, lease_expires_at = NULL,
+                last_error = NULL, completed_at = NULL, updated_at = ?
+            WHERE id = ?
+          `).run(maxAttempts, runAfter, payloadJson, now3, failed.id);
+              const revived = this.getRow(failed.id);
+              this.commit();
+              return rowToJob(revived);
+            }
+          }
           const id = randomUUID2();
           this.db.prepare(`
         INSERT INTO maintenance_jobs (
@@ -7324,15 +7386,42 @@ var init_maintenance_jobs = __esm({
         const now3 = options.now ?? Date.now();
         const delayMs = Number.isFinite(options.delayMs) ? Math.max(0, Math.floor(options.delayMs)) : 0;
         const payloadJson = options.payload === void 0 ? null : JSON.stringify(options.payload);
+        const status = options.status === "retry" ? "retry" : "pending";
+        const hasLastError = options.lastError !== void 0;
+        const lastError = hasLastError ? errorText(options.lastError) : null;
         this.db.prepare(`
       UPDATE maintenance_jobs
-      SET status = 'pending', run_after = ?, attempts = CASE WHEN ? THEN 0 ELSE attempts END,
+      SET status = ?, run_after = ?, attempts = CASE WHEN ? THEN 0 ELSE attempts END,
           payload_json = COALESCE(?, payload_json),
+          last_error = CASE
+            WHEN ? THEN NULL
+            WHEN ? THEN ?
+            ELSE last_error
+          END,
           lease_owner = NULL, lease_expires_at = NULL, updated_at = ?
       WHERE id = ? AND status = 'running' AND lease_owner = ?
-    `).run(now3 + delayMs, options.resetAttempts ? 1 : 0, payloadJson, now3, id, workerId);
+    `).run(
+          status,
+          now3 + delayMs,
+          options.resetAttempts ? 1 : 0,
+          payloadJson,
+          options.clearLastError ? 1 : 0,
+          hasLastError ? 1 : 0,
+          lastError,
+          now3,
+          id,
+          workerId
+        );
         return this.get(id);
       }
+      resolveFailedVectorBackfills(projectId, dedupeKey = "vector-backfill", now3 = Date.now()) {
+        const result = this.db.prepare(`
+      UPDATE maintenance_jobs
+      SET status = 'completed', completed_at = ?, updated_at = ?
+      WHERE project_id = ? AND kind = 'vector-backfill' AND dedupe_key = ? AND status = 'failed'
+    `).run(now3, now3, projectId, dedupeKey);
+        return Number(result.changes ?? 0);
+      }
       fail(id, workerId, error, now3 = Date.now()) {
         this.begin();
         try {
@@ -7428,6 +7517,9 @@ var init_maintenance_jobs = __esm({
                 delayMs: result.delayMs,
                 resetAttempts: result.resetAttempts,
                 payload: result.payload,
+                status: result.status,
+                lastError: result.lastError,
+                clearLastError: result.clearLastError,
                 now: now3
               });
               return { state: "rescheduled", job: updated2 };
@@ -8123,10 +8215,10 @@ var init_store = __esm({
         return row ? rowToSnapshot(row) : void 0;
       }
       listSnapshots(projectId, limit = 20) {
-        const safeLimit = Number.isFinite(limit) ? Math.max(1, Math.min(200, Math.floor(limit))) : 20;
+        const safeLimit2 = Number.isFinite(limit) ? Math.max(1, Math.min(200, Math.floor(limit))) : 20;
         return this.db.prepare(
           "SELECT * FROM code_state_snapshots WHERE projectId = ? ORDER BY sourceEpoch DESC LIMIT ?"
-        ).all(projectId, safeLimit).map(rowToSnapshot);
+        ).all(projectId, safeLimit2).map(rowToSnapshot);
       }
       /**
        * Record a completed scan and mark all current structural facts with its
@@ -8406,6 +8498,9 @@ function normalizeEmbeddingFailure(error) {
     message: raw
   };
 }
+function vectorBackfillError(error) {
+  return sanitizeCredentials(normalizeEmbeddingFailure(error).message).slice(0, 1e3);
+}
 function queueVectorBackfill(projectId) {
   const dataDir = projectDir;
   if (!dataDir) return;
@@ -9161,17 +9256,53 @@ async function backfillVectorEmbeddings(options = {}) {
   let succeeded = 0;
   let failed = 0;
   let lastFailure;
+  const recordFailure = (message) => {
+    if (!lastFailure) lastFailure = message;
+  };
+  const candidates = [];
+  for (const id of ids) {
+    const observation = observationById.get(id);
+    if (!observation) {
+      vectorMissingIds.delete(id);
+      continue;
+    }
+    candidates.push({
+      id,
+      observation,
+      text: [observation.title, observation.narrative, ...observation.facts].join(" ")
+    });
+  }
   try {
-    for (const id of ids) {
-      const obs = observationById.get(id);
-      if (!obs) {
-        vectorMissingIds.delete(id);
-        continue;
+    if (candidates.length === 0) {
+      return { attempted: ids.length, succeeded, failed };
+    }
+    let embeddings = null;
+    try {
+      const provider2 = await getEmbeddingProvider();
+      if (!provider2) {
+        if (isEmbeddingExplicitlyDisabled()) {
+          for (const candidate of candidates) vectorMissingIds.delete(candidate.id);
+        } else {
+          recordFailure("embedding provider unavailable");
+          failed += candidates.length;
+        }
+      } else {
+        embeddings = await provider2.embedBatch(candidates.map((candidate) => candidate.text));
       }
-      const text = [obs.title, obs.narrative, ...obs.facts].join(" ");
-      try {
-        const embedding = await generateEmbedding(text);
-        if (embedding) {
+    } catch (error) {
+      recordFailure(vectorBackfillError(error));
+      failed += candidates.length;
+    }
+    if (embeddings) {
+      for (let index = 0; index < candidates.length; index++) {
+        const { id, observation: obs } = candidates[index];
+        const embedding = embeddings[index];
+        if (!embedding || embedding.length === 0) {
+          recordFailure("embedding provider returned no vector");
+          failed++;
+          continue;
+        }
+        try {
           if (!isVectorCompatibleWithCurrentIndex(embedding)) {
             await upgradeVectorSchemaAfterFirstEmbedding(embedding);
           }
@@ -9180,7 +9311,7 @@ async function backfillVectorEmbeddings(options = {}) {
             console.error(
               `[memorix] Backfill embedding mismatch for obs-${id}: provider returned ${embedding.length}d, index expects ${vectorDimensions ?? "unknown"}d (kept in queue)`
             );
-            lastFailure = `dimension mismatch: provider returned ${embedding.length}d, index expects ${vectorDimensions ?? "unknown"}d`;
+            recordFailure(`dimension mismatch: provider returned ${embedding.length}d, index expects ${vectorDimensions ?? "unknown"}d`);
             failed++;
             continue;
           }
@@ -9219,15 +9350,10 @@ async function backfillVectorEmbeddings(options = {}) {
           await insertObservation(doc);
           vectorMissingIds.delete(id);
           succeeded++;
-        } else if (isEmbeddingExplicitlyDisabled()) {
-          vectorMissingIds.delete(id);
-        } else {
-          lastFailure = "embedding provider unavailable";
+        } catch (error) {
+          recordFailure(vectorBackfillError(error));
           failed++;
         }
-      } catch (err) {
-        lastFailure = err instanceof Error ? err.message : String(err);
-        failed++;
       }
     }
   } finally {
@@ -9240,7 +9366,12 @@ async function backfillVectorEmbeddings(options = {}) {
       finishedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
-  return { attempted: ids.length, succeeded, failed };
+  return {
+    attempted: ids.length,
+    succeeded,
+    failed,
+    ...lastFailure ? { lastError: lastFailure } : {}
+  };
 }
 var observations, nextId, projectDir, searchIndexPrepared, vectorMissingIds, vectorBackfillRunning, vectorSchemaUpgradePromise, lastVectorBackfill, embeddingFailureLogTimestamps, EMBEDDING_FAILURE_LOG_COOLDOWN_MS;
 var init_observations = __esm({
@@ -14877,6 +15008,26 @@ function vectorBatchSize(payload) {
   if (typeof value !== "number" || !Number.isFinite(value)) return DEFAULT_VECTOR_BATCH_SIZE;
   return Math.min(100, Math.max(1, Math.floor(value)));
 }
+function vectorBackfillFailureStreak(payload) {
+  const value = payload.vectorBackfillFailureStreak;
+  return typeof value === "number" && Number.isFinite(value) ? Math.min(16, Math.max(0, Math.floor(value))) : 0;
+}
+function vectorBackfillRetryDelayMs(streak) {
+  return Math.min(
+    VECTOR_FAILURE_MAX_RETRY_DELAY_MS,
+    VECTOR_FAILURE_BASE_RETRY_DELAY_MS * 2 ** Math.max(0, streak - 1)
+  );
+}
+function withoutVectorBackfillFailureStreak(payload) {
+  const { vectorBackfillFailureStreak: _streak, ...rest } = payload;
+  return rest;
+}
+function resolveSupersededVectorFailures(projectDir2, projectId) {
+  try {
+    new MaintenanceJobStore(projectDir2).resolveFailedVectorBackfills(projectId);
+  } catch {
+  }
+}
 function retentionBatchSize(payload) {
   const value = payload.limit;
   if (typeof value !== "number" || !Number.isFinite(value)) return DEFAULT_RETENTION_BATCH_SIZE;
@@ -15285,20 +15436,45 @@ function createProjectMaintenanceHandler(projectId, projectDir2, projectRoot, op
     if (isEmbeddingExplicitlyDisabled2()) return { action: "complete" };
     const { backfillVectorEmbeddings: backfillVectorEmbeddings2, getVectorStatus: getVectorStatus2 } = await Promise.resolve().then(() => (init_observations(), observations_exports));
     const before = getVectorStatus2(projectId);
-    if (before.missing === 0) return { action: "complete" };
+    if (before.missing === 0) {
+      resolveSupersededVectorFailures(projectDir2, projectId);
+      return { action: "complete" };
+    }
     const result = await backfillVectorEmbeddings2({
       projectId,
       limit: vectorBatchSize(job.payload)
     });
     const after = getVectorStatus2(projectId);
-    if (after.missing === 0) return { action: "complete" };
+    if (after.missing === 0) {
+      resolveSupersededVectorFailures(projectDir2, projectId);
+      return { action: "complete" };
+    }
     if (result.failed > 0 && result.succeeded === 0) {
-      throw new Error(`vector backfill made no progress (${result.failed}/${result.attempted} failed)`);
+      const streak = vectorBackfillFailureStreak(job.payload) + 1;
+      return {
+        action: "reschedule",
+        status: "retry",
+        delayMs: vectorBackfillRetryDelayMs(streak),
+        // This is a recoverable provider/index state, not a terminal job error.
+        // Keeping one retry row prevents new MCP processes from creating a storm.
+        resetAttempts: true,
+        payload: {
+          ...job.payload,
+          vectorBackfillFailureStreak: streak
+        },
+        lastError: result.lastError ?? `vector backfill made no progress (${result.failed}/${result.attempted} failed)`
+      };
     }
+    const priorFailureStreak = vectorBackfillFailureStreak(job.payload);
+    const payload = withoutVectorBackfillFailureStreak(job.payload);
     return {
       action: "reschedule",
       delayMs: result.attempted === 0 ? VECTOR_RETRY_DELAY_MS : 0,
-      resetAttempts: result.succeeded > 0
+      resetAttempts: result.succeeded > 0,
+      ...result.succeeded > 0 ? {
+        ...priorFailureStreak > 0 ? { payload } : {},
+        ...result.failed > 0 && result.lastError ? { lastError: result.lastError } : priorFailureStreak > 0 ? { clearLastError: true } : {}
+      } : {}
     };
   };
 }
@@ -15311,11 +15487,12 @@ function createProjectMaintenanceDispatcher(projectId, projectDir2, projectRoot,
     return isolatedRunner({ job, projectRoot, dataDir: projectDir2 });
   };
 }
-var DEFAULT_VECTOR_BATCH_SIZE, DEFAULT_RETENTION_BATCH_SIZE, DEFAULT_CONSOLIDATION_BATCH_SIZE, DEFAULT_CODEGRAPH_MAX_FILES, DEFAULT_CLAIM_DERIVATION_BATCH_SIZE, DEFAULT_OBSERVATION_QUALIFICATION_BATCH_SIZE, VECTOR_RETRY_DELAY_MS, DEDUP_PER_PAIR_TIMEOUT_MS;
+var DEFAULT_VECTOR_BATCH_SIZE, DEFAULT_RETENTION_BATCH_SIZE, DEFAULT_CONSOLIDATION_BATCH_SIZE, DEFAULT_CODEGRAPH_MAX_FILES, DEFAULT_CLAIM_DERIVATION_BATCH_SIZE, DEFAULT_OBSERVATION_QUALIFICATION_BATCH_SIZE, VECTOR_RETRY_DELAY_MS, VECTOR_FAILURE_BASE_RETRY_DELAY_MS, VECTOR_FAILURE_MAX_RETRY_DELAY_MS, DEDUP_PER_PAIR_TIMEOUT_MS;
 var init_project_maintenance = __esm({
   "src/runtime/project-maintenance.ts"() {
     "use strict";
     init_esm_shims();
+    init_maintenance_jobs();
     init_isolated_maintenance();
     init_lifecycle();
     init_timeout();
@@ -15326,6 +15503,8 @@ var init_project_maintenance = __esm({
     DEFAULT_CLAIM_DERIVATION_BATCH_SIZE = 100;
     DEFAULT_OBSERVATION_QUALIFICATION_BATCH_SIZE = 100;
     VECTOR_RETRY_DELAY_MS = 5e3;
+    VECTOR_FAILURE_BASE_RETRY_DELAY_MS = 6e4;
+    VECTOR_FAILURE_MAX_RETRY_DELAY_MS = 15 * 6e4;
     DEDUP_PER_PAIR_TIMEOUT_MS = 5e3;
   }
 });
@@ -15983,7 +16162,7 @@ function renderTaskWorksetPrompt(input) {
   });
   appendLine(lines, "Task lens: " + input.lens, maxTokens, omitted, "lens");
   const hasContinuation = Boolean(
-    input.continuation?.previousSession || (input.continuation?.memories.length ?? 0) > 0
+    input.continuation?.previousSession || (input.continuation?.memories.length ?? 0) > 0 || input.continuation?.compactCheckpoint
   );
   if (hasContinuation && input.continuation) {
     appendLine(lines, "", maxTokens, omitted, "continuation-heading");
@@ -16023,6 +16202,24 @@ function renderTaskWorksetPrompt(input) {
         }
       );
     }
+    if (input.continuation.compactCheckpoint) {
+      const checkpoint = input.continuation.compactCheckpoint;
+      const source = `${checkpoint.agent}, ${checkpoint.captureKind}, ${checkpoint.reason}`;
+      appendLine(
+        lines,
+        "- Recent host compact checkpoint (" + source + "): " + short(checkpoint.summary, 36),
+        maxTokens,
+        omitted,
+        "continuation-compact-checkpoint",
+        selected,
+        {
+          kind: "continuation",
+          id: "compact:" + checkpoint.id,
+          reason: "recent host-native compact lifecycle evidence",
+          trust: "historical"
+        }
+      );
+    }
   }
   if (input.cautions.length > 0 || input.cautionMemory.length > 0) {
     appendLine(lines, "", maxTokens, omitted, "caution-heading");
@@ -16292,7 +16489,7 @@ async function buildTaskWorkset(input) {
     ...input.verificationHints
   ]).slice(0, 4);
   const normalizedCautions = unique(cautions.map((caution) => caution.kind)).map((kind) => cautions.find((caution) => caution.kind === kind)).slice(0, 6);
-  const continuation = input.continuation && (input.continuation.previousSession || input.continuation.memories.length > 0) ? {
+  const continuation = input.continuation && (input.continuation.previousSession || input.continuation.memories.length > 0 || input.continuation.compactCheckpoint) ? {
     ...input.continuation.previousSession ? {
       previousSession: {
         ...input.continuation.previousSession,
@@ -16303,7 +16500,13 @@ async function buildTaskWorkset(input) {
       ...memory,
       title: short(memory.title, 20),
       ...memory.detail ? { detail: short(memory.detail, CONTINUATION_DETAIL_TOKEN_BUDGET) } : {}
-    }))
+    })),
+    ...input.continuation.compactCheckpoint ? {
+      compactCheckpoint: {
+        ...input.continuation.compactCheckpoint,
+        summary: short(input.continuation.compactCheckpoint.summary, 44)
+      }
+    } : {}
   } : void 0;
   const base = {
     version: "1.2",
@@ -17119,6 +17322,311 @@ var init_project_context = __esm({
   }
 });
 
+// src/store/compaction-checkpoint-store.ts
+var compaction_checkpoint_store_exports = {};
+__export(compaction_checkpoint_store_exports, {
+  CompactionCheckpointStore: () => CompactionCheckpointStore
+});
+import { createHash as createHash13, randomUUID as randomUUID8 } from "crypto";
+function optionalText5(value) {
+  return typeof value === "string" && value ? value : void 0;
+}
+function optionalNumber2(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function parseDetails(value) {
+  if (typeof value !== "string" || !value) return void 0;
+  try {
+    const parsed = JSON.parse(value);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function sanitizeSummary(value) {
+  if (!value?.trim()) return void 0;
+  return sanitizeCredentials(value).slice(0, MAX_SUMMARY_CHARS).trim() || void 0;
+}
+function sanitizeDetails(value) {
+  if (!value) return void 0;
+  try {
+    const sanitized = sanitizeCredentials(JSON.stringify(value));
+    if (sanitized.length > MAX_DETAILS_CHARS) return { truncated: true };
+    const parsed = JSON.parse(sanitized);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return { unavailable: true };
+  }
+}
+function sourceKeyFor(input, summary) {
+  if (input.sourceKey?.trim()) return input.sourceKey.trim().slice(0, 300);
+  const material = [
+    input.projectId,
+    input.sessionId,
+    input.agent,
+    input.sourceEvent,
+    summary ?? "",
+    input.tokensBefore ?? "",
+    input.firstKeptEntryId ?? ""
+  ].join("\0");
+  return `derived:${createHash13("sha256").update(material).digest("hex").slice(0, 32)}`;
+}
+function rowToCheckpoint(row) {
+  return {
+    id: row.id,
+    projectId: row.project_id,
+    sessionId: row.session_id,
+    agent: row.agent,
+    phase: row.phase,
+    captureKind: row.capture_kind,
+    reason: row.reason,
+    sourceEvent: row.source_event,
+    sourceKey: row.source_key,
+    ...optionalText5(row.summary) ? { summary: row.summary } : {},
+    ...optionalNumber2(row.tokens_before) !== void 0 ? { tokensBefore: Number(row.tokens_before) } : {},
+    ...optionalText5(row.first_kept_entry_id) ? { firstKeptEntryId: row.first_kept_entry_id } : {},
+    ...parseDetails(row.details_json) ? { details: parseDetails(row.details_json) } : {},
+    transcriptAvailable: Boolean(row.transcript_available),
+    status: row.status,
+    preCapturedAt: row.pre_captured_at,
+    ...optionalText5(row.completed_at) ? { completedAt: row.completed_at } : {},
+    ...optionalText5(row.delivered_at) ? { deliveredAt: row.delivered_at } : {},
+    deliveryCount: Number(row.delivery_count ?? 0),
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+function safeReason(value) {
+  return value === "manual" || value === "auto" ? value : "unknown";
+}
+function safeLimit(value, fallback) {
+  if (!Number.isFinite(value) || value == null) return fallback;
+  return Math.max(1, Math.min(500, Math.floor(value)));
+}
+var MAX_SUMMARY_CHARS, MAX_DETAILS_CHARS, CompactionCheckpointStore;
+var init_compaction_checkpoint_store = __esm({
+  "src/store/compaction-checkpoint-store.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_secret_filter();
+    init_sqlite_db();
+    MAX_SUMMARY_CHARS = 24e3;
+    MAX_DETAILS_CHARS = 4e3;
+    CompactionCheckpointStore = class {
+      db;
+      constructor(dataDir) {
+        this.db = getDatabase(dataDir);
+      }
+      recordPreflight(input) {
+        const pending = this.db.prepare(`
+      SELECT * FROM compaction_checkpoints
+      WHERE project_id = ? AND session_id = ? AND agent = ?
+        AND phase = 'pre' AND status = 'active'
+      ORDER BY pre_captured_at DESC, created_at DESC
+      LIMIT 1
+    `).get(input.projectId, input.sessionId, input.agent);
+        if (pending) return rowToCheckpoint(pending);
+        const now3 = input.capturedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+        const checkpoint = {
+          id: randomUUID8(),
+          projectId: input.projectId,
+          sessionId: input.sessionId,
+          agent: input.agent,
+          phase: "pre",
+          captureKind: "preflight",
+          reason: safeReason(input.reason),
+          sourceEvent: input.sourceEvent,
+          sourceKey: `pre:${randomUUID8()}`,
+          transcriptAvailable: Boolean(input.transcriptAvailable),
+          status: "active",
+          preCapturedAt: now3,
+          deliveryCount: 0,
+          createdAt: now3,
+          updatedAt: now3
+        };
+        this.insert(checkpoint);
+        return checkpoint;
+      }
+      complete(input) {
+        const completedAt = input.completedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+        const summary = sanitizeSummary(input.summary);
+        const pending = this.db.prepare(`
+      SELECT * FROM compaction_checkpoints
+      WHERE project_id = ? AND session_id = ? AND agent = ?
+        AND phase = 'pre' AND status = 'active'
+      ORDER BY pre_captured_at DESC, created_at DESC
+      LIMIT 1
+    `).get(input.projectId, input.sessionId, input.agent);
+        if (!input.sourceKey?.trim() && !summary && input.tokensBefore === void 0 && !input.firstKeptEntryId && !pending) {
+          const priorLifecycle = this.db.prepare(`
+        SELECT * FROM compaction_checkpoints
+        WHERE project_id = ? AND session_id = ? AND agent = ?
+          AND phase = 'complete' AND capture_kind = 'lifecycle'
+          AND source_event = ? AND status = 'active'
+        ORDER BY completed_at DESC, created_at DESC
+        LIMIT 1
+      `).get(input.projectId, input.sessionId, input.agent, input.sourceEvent);
+          if (priorLifecycle) return rowToCheckpoint(priorLifecycle);
+        }
+        const sourceKey = input.sourceKey?.trim() ? input.sourceKey.trim().slice(0, 300) : pending ? `lifecycle:${pending.id}` : sourceKeyFor(input, summary);
+        const existing = this.db.prepare(`
+      SELECT * FROM compaction_checkpoints
+      WHERE project_id = ? AND source_key = ?
+      LIMIT 1
+    `).get(input.projectId, sourceKey);
+        if (existing) return rowToCheckpoint(existing);
+        const captureKind = summary ? "native-summary" : "lifecycle";
+        const details = sanitizeDetails(input.details);
+        if (pending) {
+          const checkpoint2 = rowToCheckpoint(pending);
+          const nextReason = safeReason(input.reason) === "unknown" ? checkpoint2.reason : safeReason(input.reason);
+          this.db.prepare(`
+        UPDATE compaction_checkpoints
+        SET phase = 'complete', capture_kind = ?, reason = ?, source_event = ?, source_key = ?,
+            summary = ?, tokens_before = ?, first_kept_entry_id = ?, details_json = ?,
+            completed_at = ?, updated_at = ?
+        WHERE id = ?
+      `).run(
+            captureKind,
+            nextReason,
+            input.sourceEvent,
+            sourceKey,
+            summary ?? null,
+            input.tokensBefore ?? null,
+            input.firstKeptEntryId ?? null,
+            JSON.stringify(details ?? {}),
+            completedAt,
+            completedAt,
+            checkpoint2.id
+          );
+          return this.get(checkpoint2.id);
+        }
+        const checkpoint = {
+          id: randomUUID8(),
+          projectId: input.projectId,
+          sessionId: input.sessionId,
+          agent: input.agent,
+          phase: "complete",
+          captureKind,
+          reason: safeReason(input.reason),
+          sourceEvent: input.sourceEvent,
+          sourceKey,
+          ...summary ? { summary } : {},
+          ...input.tokensBefore !== void 0 ? { tokensBefore: input.tokensBefore } : {},
+          ...input.firstKeptEntryId ? { firstKeptEntryId: input.firstKeptEntryId } : {},
+          ...details ? { details } : {},
+          transcriptAvailable: false,
+          status: "active",
+          preCapturedAt: completedAt,
+          completedAt,
+          deliveryCount: 0,
+          createdAt: completedAt,
+          updatedAt: completedAt
+        };
+        this.insert(checkpoint);
+        return checkpoint;
+      }
+      get(id) {
+        const row = this.db.prepare("SELECT * FROM compaction_checkpoints WHERE id = ?").get(id);
+        return row ? rowToCheckpoint(row) : void 0;
+      }
+      list(options) {
+        const conditions = ["project_id = ?"];
+        const values = [options.projectId];
+        if (options.sessionId) {
+          conditions.push("session_id = ?");
+          values.push(options.sessionId);
+        }
+        if (options.agent) {
+          conditions.push("agent = ?");
+          values.push(options.agent);
+        }
+        if (!options.includeArchived) {
+          conditions.push("status = 'active'");
+        }
+        const rows = this.db.prepare(`
+      SELECT * FROM compaction_checkpoints
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY COALESCE(completed_at, pre_captured_at) DESC, created_at DESC
+      LIMIT ?
+    `).all(...values, safeLimit(options.limit, 20));
+        return rows.map(rowToCheckpoint);
+      }
+      findUndelivered(projectId, sessionId, agent) {
+        const row = this.db.prepare(`
+      SELECT * FROM compaction_checkpoints
+      WHERE project_id = ? AND session_id = ? AND agent = ?
+        AND phase = 'complete' AND status = 'active' AND delivered_at IS NULL
+      ORDER BY completed_at DESC, created_at DESC
+      LIMIT 1
+    `).get(projectId, sessionId, agent);
+        return row ? rowToCheckpoint(row) : void 0;
+      }
+      findLatestCompleted(projectId, options = {}) {
+        const excludeSession = options.excludeSession;
+        const exclusion = excludeSession ? " AND NOT (session_id = ? AND agent = ? )" : "";
+        const values = excludeSession ? [projectId, excludeSession.sessionId, excludeSession.agent] : [projectId];
+        const row = this.db.prepare(`
+      SELECT * FROM compaction_checkpoints
+      WHERE project_id = ? AND phase = 'complete' AND status = 'active'
+      ${exclusion}
+      ORDER BY completed_at DESC, created_at DESC
+      LIMIT 1
+    `).get(...values);
+        return row ? rowToCheckpoint(row) : void 0;
+      }
+      archive(id, archivedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+        const result = this.db.prepare(`
+      UPDATE compaction_checkpoints
+      SET status = 'archived', updated_at = ?
+      WHERE id = ? AND status = 'active'
+    `).run(archivedAt, id);
+        return Number(result.changes ?? 0) > 0 ? this.get(id) : void 0;
+      }
+      markDelivered(id, deliveredAt = (/* @__PURE__ */ new Date()).toISOString()) {
+        const result = this.db.prepare(`
+      UPDATE compaction_checkpoints
+      SET delivered_at = ?, delivery_count = delivery_count + 1, updated_at = ?
+      WHERE id = ? AND phase = 'complete' AND status = 'active' AND delivered_at IS NULL
+    `).run(deliveredAt, deliveredAt, id);
+        return Number(result.changes ?? 0) > 0 ? this.get(id) : void 0;
+      }
+      insert(checkpoint) {
+        this.db.prepare(`
+      INSERT INTO compaction_checkpoints (
+        id, project_id, session_id, agent, phase, capture_kind, reason,
+        source_event, source_key, summary, tokens_before, first_kept_entry_id,
+        details_json, transcript_available, status, pre_captured_at, completed_at,
+        delivered_at, delivery_count, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(
+          checkpoint.id,
+          checkpoint.projectId,
+          checkpoint.sessionId,
+          checkpoint.agent,
+          checkpoint.phase,
+          checkpoint.captureKind,
+          checkpoint.reason,
+          checkpoint.sourceEvent,
+          checkpoint.sourceKey,
+          checkpoint.summary ?? null,
+          checkpoint.tokensBefore ?? null,
+          checkpoint.firstKeptEntryId ?? null,
+          JSON.stringify(checkpoint.details ?? {}),
+          checkpoint.transcriptAvailable ? 1 : 0,
+          checkpoint.status,
+          checkpoint.preCapturedAt,
+          checkpoint.completedAt ?? null,
+          checkpoint.deliveredAt ?? null,
+          checkpoint.deliveryCount,
+          checkpoint.createdAt,
+          checkpoint.updatedAt
+        );
+      }
+    };
+  }
+});
+
 // src/codegraph/auto-context.ts
 var auto_context_exports = {};
 __export(auto_context_exports, {
@@ -17304,6 +17812,22 @@ async function buildAutoProjectContext(input) {
   if (continuationRequested) {
     await initSessionStore(input.dataDir);
     continuation = await getSessionResumeBrief(input.project.id, task, input.reader);
+    const { CompactionCheckpointStore: CompactionCheckpointStore2 } = await Promise.resolve().then(() => (init_compaction_checkpoint_store(), compaction_checkpoint_store_exports));
+    const checkpoint = new CompactionCheckpointStore2(input.dataDir).findLatestCompleted(
+      input.project.id,
+      input.excludeCompactionCheckpointFor ? { excludeSession: input.excludeCompactionCheckpointFor } : void 0
+    );
+    const completedAtMs = checkpoint ? Date.parse(checkpoint.completedAt ?? checkpoint.preCapturedAt) : Number.NaN;
+    if (checkpoint && Number.isFinite(completedAtMs) && completedAtMs <= now3.getTime() && now3.getTime() - completedAtMs <= COMPACT_CHECKPOINT_MAX_AGE_MS) {
+      continuation.compactCheckpoint = {
+        id: checkpoint.id,
+        agent: checkpoint.agent,
+        captureKind: checkpoint.captureKind === "native-summary" ? "native-summary" : "lifecycle",
+        reason: checkpoint.reason,
+        ...checkpoint.completedAt ? { completedAt: checkpoint.completedAt } : {},
+        summary: checkpoint.summary ?? "The host completed context compaction without exposing a native summary. Reconstruct only what the current task needs from current code and durable evidence."
+      };
+    }
   }
   const workset = await buildTaskWorkset({
     projectId: input.project.id,
@@ -17512,7 +18036,7 @@ function formatAutoProjectContextSummary(context) {
     reliableSources.length > 0 ? `- ${reliableSources.length} current code-bound memory link(s)` : "- none yet"
   );
   const continuation = context.workset.continuation;
-  if (continuation?.previousSession || continuation?.memories.length) {
+  if (continuation?.previousSession || continuation?.memories.length || continuation?.compactCheckpoint) {
     lines.push("", "Resume from prior work");
     if (continuation.previousSession) {
       const session = continuation.previousSession;
@@ -17527,6 +18051,12 @@ function formatAutoProjectContextSummary(context) {
         "- #" + memory.id + " " + memory.type + ": " + compactContinuationText(memory.title, 18) + detail
       );
     }
+    if (continuation.compactCheckpoint) {
+      const checkpoint = continuation.compactCheckpoint;
+      lines.push(
+        "- Recent host compact checkpoint (" + [checkpoint.agent, checkpoint.captureKind, checkpoint.reason].join(", ") + "): " + compactContinuationText(checkpoint.summary, 36)
+      );
+    }
   }
   return lines.join("\n");
 }
@@ -17593,7 +18123,7 @@ function formatLegacyAutoProjectContextPrompt(context) {
   );
   return lines.join("\n");
 }
-var DEFAULT_MAX_AGE_MS;
+var DEFAULT_MAX_AGE_MS, COMPACT_CHECKPOINT_MAX_AGE_MS;
 var init_auto_context = __esm({
   "src/codegraph/auto-context.ts"() {
     "use strict";
@@ -17613,6 +18143,7 @@ var init_auto_context = __esm({
     init_session_store();
     init_task_lens();
     DEFAULT_MAX_AGE_MS = 10 * 60 * 1e3;
+    COMPACT_CHECKPOINT_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
   }
 });
 
@@ -17660,7 +18191,7 @@ function addDefaultVerificationHints(input) {
   return uniq2(hints);
 }
 function selectRelevantObservations(observations2, task, limit) {
-  const safeLimit = Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 20;
+  const safeLimit2 = Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : 20;
   const taskTokens2 = tokenize3(task);
   const ranked = observations2.map((observation, index) => ({
     observation,
@@ -17670,7 +18201,7 @@ function selectRelevantObservations(observations2, task, limit) {
   }));
   const positives = ranked.filter((item) => item.score > 0);
   const pool = positives.length > 0 ? positives : ranked;
-  return pool.sort((a, b) => b.score - a.score || b.time - a.time || b.index - a.index).slice(0, safeLimit).map((item) => item.observation);
+  return pool.sort((a, b) => b.score - a.score || b.time - a.time || b.index - a.index).slice(0, safeLimit2).map((item) => item.observation);
 }
 function assembleContextPackForTask(input) {
   const selected = selectRelevantObservations(input.observations, input.task, input.limit ?? 20);
@@ -18230,7 +18761,7 @@ __export(team_store_exports, {
   isTeamStoreInitialized: () => isTeamStoreInitialized,
   resetTeamStore: () => resetTeamStore
 });
-import { randomUUID as randomUUID8 } from "crypto";
+import { randomUUID as randomUUID9 } from "crypto";
 import path20 from "path";
 import fs15 from "fs";
 function getTeamStore() {
@@ -18519,7 +19050,7 @@ var init_team_store = __esm({
        * reactivate it (preserving agent_id). Otherwise create a new one.
        */
       registerAgent(input) {
-        const instanceId = input.instanceId || randomUUID8();
+        const instanceId = input.instanceId || randomUUID9();
         const now3 = Date.now();
         const existing = this.stmtAgentFindByInstance.get(
           input.projectId,
@@ -18545,7 +19076,7 @@ var init_team_store = __esm({
           this.eventBus?.emit("agent:joined", { agentId: row2.agent_id, projectId: input.projectId, agentType: input.agentType });
           return row2;
         }
-        const agentId = randomUUID8();
+        const agentId = randomUUID9();
         this.stmtAgentUpsert.run({
           agent_id: agentId,
           project_id: input.projectId,
@@ -18647,7 +19178,7 @@ var init_team_store = __esm({
             return { error: `Recipient agent '${input.recipientAgentId}' not found \u2014 cannot send to unknown agent` };
           }
         }
-        const id = randomUUID8();
+        const id = randomUUID9();
         const now3 = Date.now();
         const row = {
           id,
@@ -18697,7 +19228,7 @@ var init_team_store = __esm({
       // Task Operations (with atomic claim semantics)
       // ═══════════════════════════════════════════════════════════════════
       createTask(input) {
-        const taskId = randomUUID8();
+        const taskId = randomUUID9();
         const now3 = Date.now();
         const row = {
           task_id: taskId,
@@ -18969,7 +19500,7 @@ var init_team_store = __esm({
               for (const [agentId, msgs] of Object.entries(snap.messages.inboxes)) {
                 for (const msg of msgs) {
                   this.stmtMsgInsert.run({
-                    id: msg.id ?? randomUUID8(),
+                    id: msg.id ?? randomUUID9(),
                     project_id: "migrated",
                     sender_agent_id: msg.from ?? "unknown",
                     recipient_agent_id: msg.to === "__broadcast__" ? null : msg.to ?? agentId,
@@ -19209,6 +19740,140 @@ var init_poll = __esm({
   }
 });
 
+// src/memory/compaction.ts
+var compaction_exports = {};
+__export(compaction_exports, {
+  buildCompactionWorkset: () => buildCompactionWorkset,
+  captureCompactionCheckpoint: () => captureCompactionCheckpoint,
+  consumeCompactionWorkset: () => consumeCompactionWorkset
+});
+function normalizeBudget(value) {
+  if (!Number.isFinite(value) || value == null) return DEFAULT_WORKSET_BUDGET;
+  return Math.max(MIN_WORKSET_BUDGET, Math.min(2e3, Math.floor(value)));
+}
+function sourceLabel(checkpoint) {
+  if (checkpoint.captureKind === "native-summary") return "native host summary";
+  if (checkpoint.captureKind === "preflight") return "pre-compact lifecycle marker";
+  return "host lifecycle marker";
+}
+function buildCompactionWorkset(checkpoint, options = {}) {
+  const budget = normalizeBudget(options.maxTokens);
+  const task = options.task?.trim() ? truncateToTokenBudget(sanitizeCredentials(options.task.trim()), Math.max(8, Math.floor(budget * 0.25))) : "";
+  const headerLines = [
+    "## Compact Continuation",
+    `- Host: ${checkpoint.agent} (${sourceLabel(checkpoint)})`,
+    `- Trigger: ${checkpoint.reason}`,
+    task ? `- Task now: ${task}` : "",
+    "- Current code remains authoritative."
+  ].filter(Boolean);
+  const header = `${headerLines.join("\n")}
+
+`;
+  const fallback = checkpoint.captureKind === "native-summary" ? "" : "The host did not expose a native compact summary. Reconstruct only what the current task needs from current code and Memorix evidence.";
+  const source = sanitizeCredentials(checkpoint.summary?.trim() || fallback);
+  const available = Math.max(0, budget - countTextTokens(header) - 4);
+  let excerpt = source ? truncateToTokenBudget(source, available) : "";
+  let text = `${header}${excerpt ? `### Host checkpoint
+${excerpt}` : ""}`.trim();
+  while (excerpt && countTextTokens(text) > budget) {
+    const nextExcerptBudget = Math.max(1, Math.floor(countTextTokens(excerpt) * 0.8));
+    excerpt = truncateToTokenBudget(excerpt, nextExcerptBudget);
+    text = `${header}${excerpt ? `### Host checkpoint
+${excerpt}` : ""}`.trim();
+  }
+  if (countTextTokens(text) > budget) text = truncateToTokenBudget(text, budget);
+  return {
+    checkpointId: checkpoint.id,
+    text,
+    tokens: countTextTokens(text)
+  };
+}
+function sourceEvent(input) {
+  const raw = input.raw;
+  const event = raw.hook_event_name ?? raw.event ?? raw.type;
+  return typeof event === "string" && event ? event : input.event;
+}
+async function captureCompactionCheckpoint(input) {
+  const isCompactResume = input.event === "session_start" && input.sessionStartReason?.trim().toLowerCase() === "compact";
+  if (input.event !== "pre_compact" && input.event !== "post_compact" && !isCompactResume) return null;
+  if (!input.sessionId || !input.cwd) return null;
+  const [
+    { detectProject: detectProject2 },
+    { getProjectDataDir: getProjectDataDir2 },
+    { initAliasRegistry: initAliasRegistry2, registerAlias: registerAlias2 }
+  ] = await Promise.all([
+    Promise.resolve().then(() => (init_detector(), detector_exports)),
+    Promise.resolve().then(() => (init_persistence(), persistence_exports)),
+    Promise.resolve().then(() => (init_aliases(), aliases_exports))
+  ]);
+  const project = detectProject2(input.cwd);
+  if (!project) return null;
+  const dataDir = await getProjectDataDir2(project.id);
+  initAliasRegistry2(dataDir);
+  const projectId = await registerAlias2(project);
+  const store = new CompactionCheckpointStore(dataDir);
+  if (input.event === "pre_compact") {
+    return store.recordPreflight({
+      projectId,
+      sessionId: input.sessionId,
+      agent: input.agent,
+      reason: input.compaction?.reason,
+      sourceEvent: sourceEvent(input),
+      transcriptAvailable: Boolean(input.transcriptPath),
+      capturedAt: input.timestamp
+    });
+  }
+  return store.complete({
+    projectId,
+    sessionId: input.sessionId,
+    agent: input.agent,
+    reason: input.compaction?.reason,
+    sourceEvent: sourceEvent(input),
+    sourceKey: input.compaction?.sourceKey,
+    summary: input.compaction?.summary,
+    tokensBefore: input.compaction?.tokensBefore,
+    firstKeptEntryId: input.compaction?.firstKeptEntryId,
+    details: input.compaction?.details,
+    completedAt: input.timestamp
+  });
+}
+async function consumeCompactionWorkset(input, options = {}) {
+  if (!input.sessionId || !input.cwd) return null;
+  const [
+    { detectProject: detectProject2 },
+    { getProjectDataDir: getProjectDataDir2 },
+    { initAliasRegistry: initAliasRegistry2, registerAlias: registerAlias2 }
+  ] = await Promise.all([
+    Promise.resolve().then(() => (init_detector(), detector_exports)),
+    Promise.resolve().then(() => (init_persistence(), persistence_exports)),
+    Promise.resolve().then(() => (init_aliases(), aliases_exports))
+  ]);
+  const project = detectProject2(input.cwd);
+  if (!project) return null;
+  const dataDir = await getProjectDataDir2(project.id);
+  initAliasRegistry2(dataDir);
+  const projectId = await registerAlias2(project);
+  const store = new CompactionCheckpointStore(dataDir);
+  const checkpoint = store.findUndelivered(projectId, input.sessionId, input.agent);
+  if (!checkpoint) return null;
+  const workset = buildCompactionWorkset(checkpoint, options);
+  if (!workset.text) return null;
+  store.markDelivered(checkpoint.id);
+  return workset;
+}
+var DEFAULT_WORKSET_BUDGET, MIN_WORKSET_BUDGET;
+var init_compaction = __esm({
+  "src/memory/compaction.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_token_budget();
+    init_secret_filter();
+    init_compaction_checkpoint_store();
+    DEFAULT_WORKSET_BUDGET = 420;
+    MIN_WORKSET_BUDGET = 48;
+  }
+});
+
 // src/memory/export-import.ts
 var export_import_exports = {};
 __export(export_import_exports, {
@@ -20174,6 +20839,17 @@ async function handleApi(req, res, dataDir, projectId, projectName, baseDir, pro
           sourceCounts,
           recentObservations: sorted,
           embedding: embeddingStatus,
+          // A standalone dashboard has no access to an active MCP
+          // process's in-memory Orama index. Keep this explicit so the
+          // UI never presents an empty local singleton as a healthy
+          // all-vectors-indexed result.
+          vectorStatus: {
+            available: false,
+            total: 0,
+            missing: 0,
+            missingIds: [],
+            backfillRunning: false
+          },
           storage: storageInfo,
           maintenance,
           ...lifecycle ? { lifecycle } : {},
@@ -21287,7 +21963,7 @@ __export(planner_exports, {
   materializeTaskGraph: () => materializeTaskGraph,
   seedAutonomousPipeline: () => seedAutonomousPipeline
 });
-import { randomUUID as randomUUID9 } from "crypto";
+import { randomUUID as randomUUID10 } from "crypto";
 function isPlannerTask(metadata) {
   if (!metadata) return null;
   try {
@@ -21345,7 +22021,7 @@ function seedAutonomousPipeline(teamStore, projectId, config, opts) {
   const maxIterations = config.maxIterations ?? 3;
   const taskBudget = config.taskBudget ?? 15;
   const structuredPlan = opts?.structuredPlan ?? true;
-  const pipelineId = randomUUID9();
+  const pipelineId = randomUUID10();
   const meta = {
     plannerType: "plan",
     pipelineId,
@@ -23416,7 +24092,7 @@ init_freshness();
 init_obs_store();
 init_mini_skill_store();
 init_session_store();
-import { createHash as createHash13 } from "crypto";
+import { createHash as createHash14 } from "crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z as z2 } from "zod";
 
@@ -26886,6 +27562,7 @@ var TOOL_PROFILES = Object.freeze({
   memorix_rules_sync: ["full"],
   memorix_workspace_sync: ["full"],
   memorix_ingest_image: ["full"],
+  memorix_compaction_checkpoint: ["full"],
   // ── MCP Official Memory Server compatibility (KG tools) ──────────
   // These are only useful to users specifically migrating from the
   // reference mcp-memory server. Hide them unless explicitly enabled.
@@ -27052,7 +27729,7 @@ function coerceObjectArray(val) {
   return [];
 }
 function createDeterministicInstanceId(projectId, agentType, agentName) {
-  const digest2 = createHash13("sha256").update(projectId).update("\n").update(agentType).update("\n").update(agentName ?? "").digest("hex").slice(0, 24);
+  const digest2 = createHash14("sha256").update(projectId).update("\n").update(agentType).update("\n").update(agentName ?? "").digest("hex").slice(0, 24);
   return `auto-${digest2}`;
 }
 var BOOTSTRAP_SAFE_TOOL_NAMES = /* @__PURE__ */ new Set([
@@ -27333,7 +28010,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.2.6" : "1.0.1"
+    version: true ? "1.2.8" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
@@ -27981,12 +28658,12 @@ Use this as the \`topicKey\` parameter in \`memorix_store\` to enable upsert beh
         if (boundary) return boundary;
       }
       return withFreshIndex(async () => {
-        const safeLimit = limit != null ? coerceNumber(limit, 20) : void 0;
+        const safeLimit2 = limit != null ? coerceNumber(limit, 20) : void 0;
         const safeMaxTokens = maxTokens != null ? coerceNumber(maxTokens, 0) : void 0;
         const TIMEOUT_MS = 3e4;
         const searchPromise = compactSearch({
           query,
-          limit: safeLimit,
+          limit: safeLimit2,
           type,
           maxTokens: safeMaxTokens,
           since,
@@ -28787,10 +29464,10 @@ Entity: ${entityName} | ${facts.length} facts | ${obs.tokens} tokens${reasoningA
         const unresolved = requireResolvedProject("search reasoning in the current project");
         if (unresolved) return unresolved;
       }
-      const safeLimit = limit != null ? coerceNumber(limit, 10) : 10;
+      const safeLimit2 = limit != null ? coerceNumber(limit, 10) : 10;
       const result = await withFreshIndex(() => compactSearch({
         query,
-        limit: safeLimit,
+        limit: safeLimit2,
         type: "reasoning",
         projectId: scope === "global" ? void 0 : project.id,
         status: "active",
@@ -30113,9 +30790,9 @@ ${summary ? "Summary saved for next session context injection." : "No summary pr
       }
     },
     async ({ limit }) => {
-      const safeLimit = limit != null ? coerceNumber(limit, 3) : 3;
+      const safeLimit2 = limit != null ? coerceNumber(limit, 3) : 3;
       const { getSessionContext: getSessionContext2, listSessions: listSessions2 } = await Promise.resolve().then(() => (init_session(), session_exports));
-      const context = await getSessionContext2(projectDir2, project.id, safeLimit, getObservationReader());
+      const context = await getSessionContext2(projectDir2, project.id, safeLimit2, getObservationReader());
       const sessions = await listSessions2(projectDir2, project.id);
       const activeSessions = sessions.filter((s) => s.status === "active");
       const completedSessions = sessions.filter((s) => s.status === "completed");
@@ -30136,6 +30813,86 @@ ${summary ? "Summary saved for next session context injection." : "No summary pr
       };
     }
   );
+  server.registerTool(
+    "memorix_compaction_checkpoint",
+    {
+      title: "Compact Continuity Checkpoints",
+      description: "Inspect, preview, or archive bounded checkpoints recorded around a host-native context compaction. Use only to debug or explicitly review compaction continuity. These are lifecycle records, not durable memories or transcript backups. CLI equivalent: memorix checkpoint list|show|context|archive.",
+      inputSchema: {
+        action: z2.enum(["list", "show", "context", "archive"]).default("list"),
+        id: z2.string().optional().describe("Checkpoint ID for show, context, or archive"),
+        sessionId: z2.string().optional().describe("Optional host session ID filter"),
+        agent: z2.string().optional().describe("Optional host agent filter"),
+        task: z2.string().optional().describe("Current task for a bounded context preview"),
+        maxTokens: z2.number().optional().describe("Maximum tokens for action=context (default: 420)"),
+        limit: z2.number().optional().describe("Maximum records for action=list (default: 20)"),
+        includeArchived: z2.boolean().optional().default(false).describe("Include archived records in action=list")
+      }
+    },
+    async ({ action, id, sessionId, agent, task, maxTokens, limit, includeArchived }) => {
+      const unresolved = requireResolvedProject("inspect compact continuity checkpoints");
+      if (unresolved) return unresolved;
+      const [{ CompactionCheckpointStore: CompactionCheckpointStore2 }, { buildCompactionWorkset: buildCompactionWorkset2 }] = await Promise.all([
+        Promise.resolve().then(() => (init_compaction_checkpoint_store(), compaction_checkpoint_store_exports)),
+        Promise.resolve().then(() => (init_compaction(), compaction_exports))
+      ]);
+      const store = new CompactionCheckpointStore2(projectDir2);
+      const assertCheckpoint = (checkpointId) => {
+        const checkpoint2 = store.get(checkpointId);
+        if (!checkpoint2 || checkpoint2.projectId !== project.id) return null;
+        return checkpoint2;
+      };
+      if (action === "list") {
+        const checkpoints = store.list({
+          projectId: project.id,
+          sessionId: sessionId?.trim() || void 0,
+          agent: agent?.trim() || void 0,
+          includeArchived: Boolean(includeArchived),
+          limit: limit != null ? Math.max(1, Math.min(100, coerceNumber(limit, 20))) : 20
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify({ projectId: project.id, checkpoints }, null, 2) }]
+        };
+      }
+      if (!id?.trim()) {
+        return {
+          content: [{ type: "text", text: "id is required for this checkpoint action." }],
+          isError: true
+        };
+      }
+      const checkpoint = assertCheckpoint(id.trim());
+      if (!checkpoint) {
+        return {
+          content: [{ type: "text", text: `Checkpoint "${id.trim()}" was not found for the current project.` }],
+          isError: true
+        };
+      }
+      if (action === "show") {
+        return {
+          content: [{ type: "text", text: JSON.stringify({ projectId: project.id, checkpoint }, null, 2) }]
+        };
+      }
+      if (action === "context") {
+        const workset = buildCompactionWorkset2(checkpoint, {
+          task: task?.trim(),
+          maxTokens: maxTokens != null ? coerceNumber(maxTokens, 420) : 420
+        });
+        return {
+          content: [{ type: "text", text: workset.text }]
+        };
+      }
+      const archived = store.archive(checkpoint.id);
+      if (!archived) {
+        return {
+          content: [{ type: "text", text: `Checkpoint "${checkpoint.id}" is already archived.` }],
+          isError: true
+        };
+      }
+      return {
+        content: [{ type: "text", text: `Archived compact checkpoint ${archived.id}.` }]
+      };
+    }
+  );
   server.registerTool(
     "memorix_transfer",
     {