memorix 1.2.6 → 1.2.7

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();
@@ -8123,10 +8161,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
@@ -15983,7 +16021,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 +16061,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 +16348,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 +16359,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 +17181,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 +17671,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 +17895,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 +17910,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 +17982,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 +18002,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 +18050,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 +18060,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 +18620,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 +18909,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 +18935,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 +19037,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 +19087,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 +19359,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 +19599,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, {
@@ -21287,7 +21811,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 +21869,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 +23940,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 +27410,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 +27577,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 +27858,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.7" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
@@ -27981,12 +28506,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 +29312,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 +30638,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 +30661,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",
     {