@remnic/core 9.66.0 → 9.66.1

package/dist/{chunk-56IV4J5W.js → chunk-TCF4MU7L.js}

@@ -13,7 +13,7 @@ import {
 import {
   ActivityStore,
   MaintenanceScheduler
-} from "./chunk-YXFCALVT.js";
+} from "./chunk-NSTNGMSS.js";
 import {
   runPeerProfileReasoner
 } from "./chunk-I74SUMNI.js";
@@ -22,7 +22,7 @@ import {
 } from "./chunk-7HYPN2GC.js";
 import {
   LcmEngine
-} from "./chunk-Z3YEGSR4.js";
+} from "./chunk-D3UXGE5D.js";
 import {
   chunkTranscriptEntries
 } from "./chunk-TECVW3JP.js";
@@ -32,27 +32,18 @@ import {
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-OAJMQKQR.js";
+} from "./chunk-IGZCAHFL.js";
 import {
   SharedContextManager
 } from "./chunk-VI637ILW.js";
-import {
-  cleanArchivedUserMessage
-} from "./chunk-47DU4SGJ.js";
 import {
   applyUtilityPromotionRuntimePolicy,
   applyUtilityRankingRuntimeDelta,
   loadUtilityRuntimeValues
 } from "./chunk-SEF4IOFE.js";
 import {
-  extractTopics
-} from "./chunk-KVDUKH5E.js";
-import {
-  buildTemporalTimelineRecallSection
-} from "./chunk-2NKY7OC6.js";
-import {
-  CODEX_THREAD_KEY_PREFIX
-} from "./chunk-4EX5WZ4M.js";
+  cleanArchivedUserMessage
+} from "./chunk-47DU4SGJ.js";
 import {
   TierMigrationExecutor
 } from "./chunk-YRFAYOFQ.js";
@@ -62,6 +53,15 @@ import {
 import {
   TmtBuilder
 } from "./chunk-ECZU5BJH.js";
+import {
+  extractTopics
+} from "./chunk-KVDUKH5E.js";
+import {
+  buildTemporalTimelineRecallSection
+} from "./chunk-2NKY7OC6.js";
+import {
+  CODEX_THREAD_KEY_PREFIX
+} from "./chunk-4EX5WZ4M.js";
 import {
   HourlySummarizer
 } from "./chunk-IEZ6CGTW.js";
@@ -72,10 +72,6 @@ import {
 import {
   SessionObserverState
 } from "./chunk-ODZKV2F7.js";
-import {
-  buildResponseGuidanceRecallSection,
-  shouldRecallResponseGuidance
-} from "./chunk-6TCXIRP5.js";
 import {
   mergeWithAgentResults,
   runDirectAgent,
@@ -100,9 +96,6 @@ import {
 import {
   applyRuntimeRetrievalPolicy
 } from "./chunk-5IZL4DCV.js";
-import {
-  findUnresolvedEntityRefs
-} from "./chunk-X7XN6YU4.js";
 import {
   RelevanceStore
 } from "./chunk-KATEWTQJ.js";
@@ -111,6 +104,16 @@ import {
   reorderByRankedKeys,
   rerankLocalOrNoop
 } from "./chunk-LUDXM7MD.js";
+import {
+  buildResponseGuidanceRecallSection,
+  shouldRecallResponseGuidance
+} from "./chunk-6TCXIRP5.js";
+import {
+  findUnresolvedEntityRefs
+} from "./chunk-X7XN6YU4.js";
+import {
+  applyRecallStateViews
+} from "./chunk-WFCWP4XU.js";
 import {
   dedupeResultsByNamespace,
   hasMemoryForResult,
@@ -191,7 +194,7 @@ import {
   buildEntityRecallSection,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-EZSCW4EM.js";
+} from "./chunk-LYUUA6QB.js";
 import {
   planEpisodeWindowsWithFallback
 } from "./chunk-T3GIETKV.js";
@@ -206,31 +209,31 @@ import {
 } from "./chunk-LVXBC6YB.js";
 import {
   refreshConvergedNamespaces
-} from "./chunk-33MFRY25.js";
+} from "./chunk-KI64TTBL.js";
 import {
   builtInConnectorPackageSpecifier,
   ensureBuiltInWearableConnectors,
   getWearableConnector,
   listWearableConnectors,
   screenCandidateFact
-} from "./chunk-6QDXA26G.js";
-import {
-  RoutingRulesStore
-} from "./chunk-TBUEE7XF.js";
+} from "./chunk-RPIS5FQ7.js";
 import {
   normalizeReplaySessionKey
 } from "./chunk-AJVLDJU6.js";
+import {
+  RoutingRulesStore
+} from "./chunk-TBUEE7XF.js";
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-ZJPM7GZ3.js";
+} from "./chunk-ZPS724LT.js";
 import {
   ThreadingManager
 } from "./chunk-OJP3N7UK.js";
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-I5VB44ZK.js";
+} from "./chunk-M5ERTI4I.js";
 import {
   searchWorkProductLedgerEntries
 } from "./chunk-NRLELHAY.js";
@@ -243,17 +246,17 @@ import {
 import {
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-2LBAFHOQ.js";
+} from "./chunk-2X6BGKQL.js";
 import {
   planNamespaceMaintenance
-} from "./chunk-72OIT7KS.js";
+} from "./chunk-S4Z2OBTX.js";
 import {
   isAboveImportanceThreshold,
   scoreImportance
 } from "./chunk-UOBPK2OS.js";
 import {
   searchHarmonicRetrieval
-} from "./chunk-VQ4AMTGZ.js";
+} from "./chunk-EWKVYCFP.js";
 import {
   EXTRACTION_JUDGE_VERDICT_CATEGORY,
   recordJudgeVerdict
@@ -281,7 +284,7 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-CN4VKV3S.js";
+} from "./chunk-INUBU6I5.js";
 import {
   semanticChunkContent
 } from "./chunk-2GBFKHBZ.js";
@@ -311,8 +314,10 @@ import {
   evaluateMemoryActionPolicy
 } from "./chunk-MI2OTWV5.js";
 import {
-  detectMeetings
-} from "./chunk-PEBH5DCK.js";
+  applyNoveltyGate,
+  detectMeetings,
+  embeddingsFromCosineHits
+} from "./chunk-AF5H7TKI.js";
 import {
   compileCorrectionRule,
   correctionsFilePath,
@@ -325,14 +330,14 @@ import {
 } from "./chunk-QW27DOHG.js";
 import {
   MeetingsInputError
-} from "./chunk-KXIXO76C.js";
+} from "./chunk-U65VJSCJ.js";
 import {
   WearablesInputError,
   describeErrorForOperator
 } from "./chunk-V7IZKJI3.js";
 import {
   NamespaceCatalog
-} from "./chunk-GX6FTSYH.js";
+} from "./chunk-GAJK3DQ5.js";
 import {
   recordDreamsPhaseRun
 } from "./chunk-EQWEIIKQ.js";
@@ -349,10 +354,10 @@ import {
   filterRecallCandidates,
   isGenericRecallExcludedPath,
   isTopLevelArchivePath
-} from "./chunk-IHGMRDEE.js";
+} from "./chunk-MUEGIKKY.js";
 import {
   importCapsule
-} from "./chunk-CTCGHNWN.js";
+} from "./chunk-J2R275FN.js";
 import {
   isCodingGraphInstalled
 } from "./chunk-VQ7B2Q6M.js";
@@ -375,7 +380,7 @@ import {
 } from "./chunk-ZVZHG7AI.js";
 import {
   buildXraySnapshot
-} from "./chunk-NPIBN2VL.js";
+} from "./chunk-LK4TOYPU.js";
 import {
   objectiveStateStoreOverrideForNamespace,
   searchObjectiveStateSnapshots
@@ -403,7 +408,7 @@ import {
 } from "./chunk-7ZNJN5WZ.js";
 import {
   NamespaceStorageRouter
-} from "./chunk-HJXA6ZM7.js";
+} from "./chunk-S4CDUXQY.js";
 import {
   GraphIndex
 } from "./chunk-YMOPYG3K.js";
@@ -460,7 +465,7 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   buildChainFollowupGenerator
-} from "./chunk-FESUGFIL.js";
+} from "./chunk-7UOXCCCI.js";
 import {
   QmdResultResolver,
   StorageManager,
@@ -479,7 +484,10 @@ import {
   reconstructFusionInputs,
   selfDeps,
   serializeFusionDay
-} from "./chunk-GEJKYA7D.js";
+} from "./chunk-2ITZ74A6.js";
+import {
+  buildRetiredFactTombstoneInputs
+} from "./chunk-4ZWCQJNM.js";
 import {
   bodyIsEscaped,
   decodeTranscriptBody,
@@ -490,18 +498,15 @@ import {
   saveSpeakerRegistry,
   speakerRegistryKey
 } from "./chunk-UHVXE24Y.js";
-import {
-  buildRetiredFactTombstoneInputs
-} from "./chunk-4ZWCQJNM.js";
 import {
   NamespaceSearchRouter,
   namespaceCollectionName
-} from "./chunk-FYWLSFFS.js";
+} from "./chunk-C5IUOBCN.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend,
   isSearchBackendEnabled
-} from "./chunk-HNPE66LB.js";
+} from "./chunk-U6NGKS32.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -515,7 +520,7 @@ import {
 } from "./chunk-S2V7RUCL.js";
 import {
   confidenceTier
-} from "./chunk-MINHJ55X.js";
+} from "./chunk-XXW32OL7.js";
 import {
   lintWorkspaceFiles,
   rotateMarkdownFileToArchive
@@ -606,7 +611,9 @@ import {
   normalizeRecallTokenSet
 } from "./chunk-YCVB7X56.js";
 import {
-  coerceBool
+  coerceBool,
+  coerceBooleanLike,
+  coerceNumber
 } from "./chunk-PQVCH2AE.js";
 import {
   graphemeUnits,
@@ -673,6 +680,9 @@ import {
   assertIsDirectoryNotSymlink,
   assertRealpathInsideRoot
 } from "./chunk-GCGJW34D.js";
+import {
+  parseFlexibleIsoTimestamp
+} from "./chunk-P7FMDTKL.js";
 import {
   canReadNamespace,
   defaultNamespaceForPrincipal,
@@ -6072,8 +6082,23 @@ var ExtractionPersistCoordinator = class {
       );
       const requireSpansPendingStatus = this.deps.config.provenance?.requireSpans === true && fact.requireSpansPending === true ? "pending_review" : void 0;
       const faithfulnessEnforceStatus = faithfulnessGateStatus ?? requireSpansPendingStatus ?? injectionScreenStatus;
+      const novelty = await applyNoveltyGate({
+        enabled: this.deps.config["noveltyGateEnabled"] === true,
+        addThreshold: this.deps.config.noveltyAddThreshold,
+        noopThreshold: this.deps.config.noveltyNoopThreshold,
+        lookup: async () => embeddingsFromCosineHits(
+          await this.deps.semanticDedupLookup(
+            fact.content,
+            this.deps.config.semanticDedupCandidates,
+            targetStorage
+          ),
+          // Same connector scoping as decideSemanticDedup below: a
+          // cross-connector neighbor must not noop this candidate.
+          { candidateConnector: sourceContext?.sourceConnector }
+        )
+      });
       let pendingSemanticSkip = null;
-      if (resolvePipelineProcessingCapabilities(this.deps.config).semanticDedup && injectionScreenStatus !== "pending_review") {
+      if (novelty.decision !== "add" && resolvePipelineProcessingCapabilities(this.deps.config).semanticDedup && injectionScreenStatus !== "pending_review") {
         let semanticDecision;
         if (batchBackendUnavailable) {
           semanticDecision = { action: "keep", reason: "backend_unavailable" };
@@ -6149,11 +6174,11 @@ var ExtractionPersistCoordinator = class {
         }
       }
       const isCorrection = writeCategory === "correction";
-      if (pendingSemanticSkip && !contradictionDetected && !isCorrection && faithfulnessEnforceStatus !== "pending_review") {
+      if ((pendingSemanticSkip || novelty.decision === "noop") && !contradictionDetected && !isCorrection && faithfulnessEnforceStatus !== "pending_review") {
         log.debug(
-          `dedup: skipping semantic near-duplicate fact "${fact.content.slice(0, 60).replace(/\s+/g, " ")}\u2026" score=${pendingSemanticSkip.topScore.toFixed(
+          `dedup: skipping ${pendingSemanticSkip ? "semantic near-duplicate" : "novelty-noop"} fact "${fact.content.slice(0, 60).replace(/\s+/g, " ")}\u2026" score=${(pendingSemanticSkip?.topScore ?? novelty.score).toFixed(
             3
-          )} neighbor=${pendingSemanticSkip.topId}`
+          )} neighbor=${pendingSemanticSkip?.topId ?? novelty.neighborId}`
         );
         dedupedCount++;
         continue;
@@ -18959,14 +18984,14 @@ var NamespaceReadFanoutCoordinator = class {
     for (const { memory, namespace } of memories) {
       const status = memory.frontmatter.status ?? "active";
       if (!options?.allowArchived && status !== "active") continue;
-      const haystack = [
+      const haystack2 = [
         memory.content,
         memory.frontmatter.category,
         ...memory.frontmatter.tags ?? []
       ].join(" ").toLowerCase();
       let hits = 0;
       for (const token of tokens) {
-        if (haystack.includes(token)) hits += 1;
+        if (haystack2.includes(token)) hits += 1;
       }
       const score = tokens.length > 0 ? hits / tokens.length : 0.01;
       if (tokens.length > 0 && hits === 0) continue;
@@ -19182,7 +19207,11 @@ var RecallEntryCoordinator = class {
   publishRecallResults(options) {
     const sectionId = "memories";
     const trustByPath = options.trustByPath ?? null;
-    const injectable = trustByPath ? options.results.filter((r) => !trustResultFor(trustByPath, r)?.quarantined) : options.results;
+    const injectable = applyRecallStateViews(
+      trustByPath ? options.results.filter((r) => !trustResultFor(trustByPath, r)?.quarantined) : options.results,
+      options.retrievalQuery,
+      this.deps.config
+    );
     if (injectable.length === 0) return;
     const formatted = this.deps.recallResultFormatter.formatQmdResultEntries(
       options.title,
@@ -26299,6 +26328,306 @@ function applyTimelineCorrections(cards, corrections) {
   });
 }
 
+// src/activity/timeline/query.ts
+var RANGE_FORMATS = ["cards", "compact"];
+var MS_PER_DAY = 864e5;
+var DEFAULT_MAX_RANGE_DAYS = 31;
+var DEFAULT_SEARCH_LIMIT = 10;
+var MIN_SEARCH_LIMIT = 1;
+var MAX_SEARCH_LIMIT = 50;
+var USAGE = `Usage: timeline <command> [options]
+
+Commands:
+  range --from <ISO> --to <ISO> [--format cards|compact] [--categories id,id] [--include-distractions]
+  search --query <text> [--from <ISO>] [--to <ISO>] [--limit N]
+`;
+var VALUE_FLAGS = {
+  "--from": true,
+  "--to": true,
+  "--format": true,
+  "--categories": true,
+  "--query": true,
+  "--limit": true
+};
+var BOOLEAN_FLAGS = { "--include-distractions": true };
+function parseInstant(value, label) {
+  const ms = parseFlexibleIsoTimestamp(value);
+  if (ms === null) {
+    throw new TypeError(`${label} must be an ISO date or datetime`);
+  }
+  return ms;
+}
+function assertRange(fromMs, toMs, maxRangeDays) {
+  if (fromMs > toMs) {
+    throw new RangeError("reversed range: from must be <= to");
+  }
+  if (fromMs === toMs) return;
+  if (toMs - fromMs > maxRangeDays * MS_PER_DAY) {
+    throw new RangeError(`range exceeds timeline.qa.maxRangeDays (${maxRangeDays})`);
+  }
+}
+function cardOverlaps(card, fromMs, toMs) {
+  const start = Date.parse(card.startUtc);
+  const end = Date.parse(card.endUtc);
+  if (fromMs === toMs) return start <= fromMs && fromMs < end;
+  return start < toMs && end > fromMs;
+}
+function passesFilters(card, categories, includeDistractions) {
+  if (!includeDistractions && card.distraction === true) return false;
+  if (categories && !categories.has(card.categoryId)) return false;
+  return true;
+}
+function filterRange(cards, fromMs, toMs, categories, includeDistractions) {
+  return cards.filter(
+    (card) => cardOverlaps(card, fromMs, toMs) && passesFilters(card, categories, includeDistractions)
+  );
+}
+function toCompact(cards, from) {
+  const day = from.length >= 10 ? from.slice(0, 10) : cards[0]?.dayKey ?? from;
+  return {
+    day,
+    cards: cards.map((card) => ({
+      start: card.startUtc,
+      end: card.endUtc,
+      category: card.categoryId,
+      title: card.title,
+      summary: card.summary
+    }))
+  };
+}
+function queryTimelineRange(cards, query) {
+  if (!RANGE_FORMATS.includes(query.format)) {
+    throw new TypeError(`format must be one of: ${RANGE_FORMATS.join(", ")}`);
+  }
+  const maxRangeDays = query.maxRangeDays ?? DEFAULT_MAX_RANGE_DAYS;
+  const fromMs = parseInstant(query.from, "from");
+  const toMs = parseInstant(query.to, "to");
+  assertRange(fromMs, toMs, maxRangeDays);
+  const categories = query.categories ? new Set(query.categories) : void 0;
+  const matched = filterRange(cards, fromMs, toMs, categories, query.includeDistractions === true);
+  if (query.format === "compact") return toCompact(matched, query.from);
+  return matched;
+}
+function haystack(card) {
+  const parts = [card.title, card.summary];
+  if (card.detailedSummary) parts.push(card.detailedSummary);
+  return parts.join(" ").toLowerCase();
+}
+function tokenMatchCount(card, tokens) {
+  const text = haystack(card);
+  let count = 0;
+  for (const token of tokens) {
+    if (text.includes(token)) count += 1;
+  }
+  return count;
+}
+function queryTimelineSearch(cards, query) {
+  if (!Array.isArray(cards)) return { ok: false, error: "store_unreadable" };
+  const tokens = query.query.trim().toLowerCase().split(/\s+/).filter(Boolean);
+  const limit = query.limit ?? DEFAULT_SEARCH_LIMIT;
+  if (!Number.isInteger(limit) || limit < MIN_SEARCH_LIMIT || limit > MAX_SEARCH_LIMIT) {
+    throw new RangeError(`limit must be an integer from ${MIN_SEARCH_LIMIT} to ${MAX_SEARCH_LIMIT}`);
+  }
+  let pool = cards;
+  if (query.from !== void 0 || query.to !== void 0) {
+    const fromMs = parseInstant(query.from ?? query.to, "from");
+    const toMs = parseInstant(query.to ?? query.from, "to");
+    assertRange(fromMs, toMs, DEFAULT_MAX_RANGE_DAYS);
+    pool = filterRange(cards, fromMs, toMs, void 0, true);
+  }
+  if (tokens.length === 0) return { ok: true, results: [] };
+  const ranked = pool.map((card) => ({ card, matches: tokenMatchCount(card, tokens) })).filter((row) => row.matches > 0).sort((a, b) => {
+    if (a.matches !== b.matches) return b.matches - a.matches;
+    const recency = Date.parse(b.card.endUtc) - Date.parse(a.card.endUtc);
+    if (recency !== 0) return recency;
+    return a.card.id < b.card.id ? -1 : a.card.id > b.card.id ? 1 : 0;
+  }).slice(0, limit).map((row) => row.card);
+  return { ok: true, results: ranked };
+}
+function parseFlags(args) {
+  const flags = /* @__PURE__ */ new Map();
+  const positional = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (!arg.startsWith("--")) {
+      positional.push(arg);
+      continue;
+    }
+    if (VALUE_FLAGS[arg] === true) {
+      const value = args[i + 1];
+      if (value === void 0 || value.startsWith("--")) {
+        throw new TypeError(`flag ${arg} requires a value`);
+      }
+      flags.set(arg, value);
+      i += 1;
+      continue;
+    }
+    if (BOOLEAN_FLAGS[arg] === true) {
+      flags.set(arg, true);
+      continue;
+    }
+    const known = [...Object.keys(VALUE_FLAGS), ...Object.keys(BOOLEAN_FLAGS)].sort().join(", ");
+    throw new TypeError(`unknown flag ${arg} (valid: ${known})`);
+  }
+  return { flags, positional };
+}
+function flagString(flags, name) {
+  const value = flags.get(name);
+  return typeof value === "string" ? value : void 0;
+}
+async function runTimelineCliCommand(deps, args, io) {
+  const [command, ...rest] = args;
+  try {
+    if (command === void 0 || command === "help" || command === "--help") {
+      io.stdout.write(USAGE);
+      return command === void 0 ? 1 : 0;
+    }
+    if (deps.timelineEnabled === false || !deps.qa.enabled) {
+      io.stderr.write("timeline qa disabled \u2014 set activity.timeline.qa.enabled=true\n");
+      return 1;
+    }
+    const { flags } = parseFlags(rest);
+    if (command === "range") {
+      const from = flagString(flags, "--from");
+      const to = flagString(flags, "--to");
+      if (!from || !to) throw new TypeError("range requires --from and --to");
+      if (!Array.isArray(deps.cards)) {
+        io.stderr.write("store_unreadable\n");
+        return 1;
+      }
+      const formatRaw = flagString(flags, "--format") ?? "compact";
+      if (formatRaw !== "cards" && formatRaw !== "compact") {
+        throw new TypeError("format must be one of: cards, compact");
+      }
+      const categoriesRaw = flagString(flags, "--categories");
+      const result = queryTimelineRange(deps.cards, {
+        from,
+        to,
+        format: formatRaw,
+        categories: categoriesRaw ? categoriesRaw.split(",").filter(Boolean) : void 0,
+        includeDistractions: flags.get("--include-distractions") === true,
+        maxRangeDays: deps.qa.maxRangeDays
+      });
+      io.stdout.write(`${JSON.stringify(result)}
+`);
+      return 0;
+    }
+    if (command === "search") {
+      const q = flagString(flags, "--query");
+      if (q === void 0) throw new TypeError("search requires --query");
+      const limitRaw = flagString(flags, "--limit");
+      const limit = limitRaw === void 0 ? void 0 : Number(limitRaw);
+      if (limitRaw !== void 0 && !Number.isInteger(limit)) {
+        throw new RangeError("limit must be an integer from 1 to 50");
+      }
+      const result = queryTimelineSearch(deps.cards, {
+        query: q,
+        from: flagString(flags, "--from"),
+        to: flagString(flags, "--to"),
+        limit
+      });
+      io.stdout.write(`${JSON.stringify(result)}
+`);
+      return result.ok ? 0 : 1;
+    }
+    throw new TypeError(`unknown command ${command} (valid: range, search)`);
+  } catch (err) {
+    io.stderr.write(`${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+
+// src/activity/timeline/journal-recap.ts
+function formatMinutes(ms) {
+  return `${Math.round(ms / 6e4)}m`;
+}
+function clipToWindow(cards, winStart, winEnd) {
+  const clipped = [];
+  for (const card of cards) {
+    const start = Date.parse(card.startUtc);
+    const end = Date.parse(card.endUtc);
+    if (!Number.isFinite(start) || !Number.isFinite(end)) continue;
+    const startMs = Math.max(start, winStart);
+    const endMs = Math.min(end, winEnd);
+    if (endMs <= startMs) continue;
+    clipped.push({ card, startMs, endMs, durationMs: endMs - startMs });
+  }
+  clipped.sort((left, right) => {
+    const byStart = left.startMs - right.startMs;
+    if (byStart !== 0) return byStart;
+    const byTitle = left.card.title.localeCompare(right.card.title);
+    if (byTitle !== 0) return byTitle;
+    return left.card.id.localeCompare(right.card.id);
+  });
+  return clipped;
+}
+function categoryLines(clipped) {
+  const totals = /* @__PURE__ */ new Map();
+  for (const row of clipped) {
+    totals.set(row.card.categoryId, (totals.get(row.card.categoryId) ?? 0) + row.durationMs);
+  }
+  const rows = [...totals.entries()].sort((left, right) => {
+    const byDuration = right[1] - left[1];
+    return byDuration !== 0 ? byDuration : left[0].localeCompare(right[0]);
+  });
+  if (rows.length === 0) return ["_No categories._"];
+  return rows.map(([categoryId, durationMs]) => `- ${formatMinutes(durationMs)} ${categoryId}`);
+}
+function mergeIntervals(intervals) {
+  const ordered = [...intervals].sort((left, right) => left[0] - right[0] || left[1] - right[1]);
+  const merged = [];
+  for (const [start, end] of ordered) {
+    const last = merged[merged.length - 1];
+    if (!last || start > last[1]) merged.push([start, end]);
+    else last[1] = Math.max(last[1], end);
+  }
+  return merged;
+}
+function countGaps(winStart, winEnd, intervals) {
+  const merged = mergeIntervals(intervals);
+  let gaps = 0;
+  let cursor = winStart;
+  for (const [start, end] of merged) {
+    if (start > cursor) gaps += 1;
+    cursor = Math.max(cursor, end);
+  }
+  if (cursor < winEnd) gaps += 1;
+  return gaps;
+}
+function renderDeterministicJournal(cards, options) {
+  const window = activityDayWindow(options.date, options.timezone);
+  const winStart = Date.parse(window.startUtc);
+  const winEnd = Date.parse(window.endUtc);
+  const clipped = clipToWindow(cards, winStart, winEnd);
+  const idle = clipped.filter((row) => row.card.kind === "idle").length;
+  const pause = clipped.filter((row) => row.card.kind === "pause").length;
+  const gaps = countGaps(
+    winStart,
+    winEnd,
+    clipped.map((row) => [row.startMs, row.endMs])
+  );
+  const cardLines = clipped.length === 0 ? ["_No cards._"] : clipped.map((row) => `- ${formatMinutes(row.durationMs)} ${row.card.title}`);
+  return [
+    `# Journal \u2014 ${options.date} (${options.timezone})`,
+    "",
+    "## Categories",
+    "",
+    ...categoryLines(clipped),
+    "",
+    "## Cards",
+    "",
+    ...cardLines,
+    "",
+    "## Gaps / idle / pause",
+    "",
+    `- Gaps: ${gaps}`,
+    `- Idle: ${idle}`,
+    `- Pause: ${pause}`,
+    ""
+  ].join("\n");
+}
+
 // src/activity/memory-gen.ts
 var ACTIVITY_ALLOWED_CATEGORIES = {
   decision: true,
@@ -26555,6 +26884,54 @@ async function generateActivityMemories(date, digestBody, config, deps) {
   return result;
 }
 
+// src/activity/privacy.ts
+var MS_PER_DAY2 = 864e5;
+function asRecord(value, name) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new TypeError(`${name} must be an object`);
+  }
+  return value;
+}
+function parseGate(value, key, fallback) {
+  if (value === void 0) return fallback;
+  const parsed = coerceBooleanLike(value, key);
+  if (parsed === void 0) throw new TypeError(`${key} must be a boolean`);
+  return parsed;
+}
+function parseActivityPrivacy(raw) {
+  if (raw === void 0 || raw === null) {
+    return { enabled: false, retentionDays: 0, exportIncludeObservations: false };
+  }
+  const config = asRecord(raw, "activity");
+  const enabled = parseGate(config.enabled, "activity.enabled", false);
+  let retentionDays = 0;
+  if (config.retentionDays !== void 0) {
+    const parsed = coerceNumber(config.retentionDays, "activity.retentionDays");
+    if (parsed === void 0 || !Number.isInteger(parsed) || parsed < 0) {
+      throw new RangeError("activity.retentionDays must be a non-negative integer");
+    }
+    retentionDays = parsed;
+  }
+  const exportIncludeObservations = parseGate(
+    config.exportIncludeObservations,
+    "activity.exportIncludeObservations",
+    false
+  );
+  return { enabled, retentionDays, exportIncludeObservations };
+}
+function shouldRetain(capturedAtMs, nowMs, retentionDays, enabled = true) {
+  if (!enabled) return false;
+  if (retentionDays < 0 || !Number.isInteger(retentionDays)) {
+    throw new RangeError("activity.retentionDays must be a non-negative integer");
+  }
+  if (retentionDays === 0) return true;
+  return nowMs - capturedAtMs < retentionDays * MS_PER_DAY2;
+}
+function observationsForExport(observations, policy) {
+  if (!policy.enabled || !policy.exportIncludeObservations) return [];
+  return observations;
+}
+
 // src/session-summaries/index.ts
 import { createHash as createHash10 } from "crypto";
 import { lstat as lstat3, mkdir as mkdir7, readFile as readFile7, readdir as readdir4, rename, rm, stat as stat4, writeFile as writeFile7 } from "fs/promises";
@@ -27605,8 +27982,16 @@ export {
   timelineCorrectionDatabasePath,
   TimelineCorrectionStore,
   applyTimelineCorrections,
+  queryTimelineRange,
+  queryTimelineSearch,
+  runTimelineCliCommand,
+  renderDeterministicJournal,
   isEligibleActivityFact,
   generateActivityMemories,
+  MS_PER_DAY2 as MS_PER_DAY,
+  parseActivityPrivacy,
+  shouldRetain,
+  observationsForExport,
   fuseMeeting,
   buildMeetingRecordsForDay,
   MeetingsBuilder,
@@ -27640,4 +28025,4 @@ export {
   blendGraphExpandedRecallScore,
   Orchestrator
 };
-//# sourceMappingURL=chunk-56IV4J5W.js.map
+//# sourceMappingURL=chunk-TCF4MU7L.js.map