@remnic/core 9.69.56 → 9.69.58

package/dist/activity/timeline/analysis.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Optional evidence-bound AI analysis over deterministic timeline cards
+ * (issue #2050). Provider calls arrive through the injected `complete`
+ * function; hosts build it from the local/remote seams in analysis-provider.js
+ * and the parsed `activity.timeline.analysis` config. Failures leave the
+ * cards unchanged and carry a typed failure kind. Disabled makes zero
+ * provider calls.
+ */
+import { type AnalysisFailure } from "./analysis-failure.js";
+import type { TimelineCard, TimelineCategory, TimelineCorrection, TimelineObservation } from "./types.js";
+export declare const TIMELINE_ANALYSIS_PROMPT_VERSION = 1;
+export declare const TIMELINE_ANALYSIS_BATCH_SIZE = 40;
+export declare const TIMELINE_ANALYSIS_BATCH_OVERLAP = 2;
+export declare const TIMELINE_ANALYSIS_DEFAULT_TIMEOUT_MS = 15000;
+export declare class TimelineAnalysisConfigError extends Error {
+    readonly name = "TimelineAnalysisConfigError";
+    readonly code: "invalid_config";
+    constructor(message: string);
+}
+export type TimelineAnalysisStatus = "ok" | "disabled" | "provider_failed" | "invalid_output";
+export interface TimelineAnalysisCompleteInput {
+    prompt: string;
+    provider: string;
+    model: string;
+    signal: AbortSignal;
+}
+export type TimelineAnalysisComplete = (input: TimelineAnalysisCompleteInput) => Promise<string>;
+export interface TimelineAnalysisInput {
+    enabled: boolean;
+    cards: readonly TimelineCard[];
+    observations: readonly TimelineObservation[];
+    provider?: string;
+    model?: string;
+    complete?: TimelineAnalysisComplete;
+    timeoutMs?: number;
+    date?: string;
+    timezone?: string;
+    categories?: readonly TimelineCategory[];
+    preferences?: readonly string[];
+    priorEdits?: readonly TimelineCorrection[];
+    signal?: AbortSignal;
+}
+export interface TimelineAnalysisResult {
+    status: TimelineAnalysisStatus;
+    cards: TimelineCard[];
+    provider?: string;
+    model?: string;
+    promptVersion?: number;
+    /** Typed failure detail; present only when status is a failure. */
+    failure?: AnalysisFailure;
+}
+export declare function buildTimelineAnalysisPrompt(input: {
+    date?: string;
+    timezone?: string;
+    cards: readonly TimelineCard[];
+    observations: readonly TimelineObservation[];
+    categories: readonly TimelineCategory[];
+    preferences?: readonly string[];
+    priorEdits?: readonly TimelineCorrection[];
+}): string;
+/** Analyze one day of cards. Failures return the input cards unchanged. */
+export declare function analyzeTimelineCards(input: TimelineAnalysisInput): Promise<TimelineAnalysisResult>;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/activity/timeline/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAA2B,KAAK,eAAe,EAA4B,MAAM,uBAAuB,CAAC;AAKhH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAyB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjI,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,eAAO,MAAM,oCAAoC,QAAS,CAAC;AAE3D,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAkB,IAAI,iCAAiC;IACvD,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;gBAC9B,OAAO,EAAE,MAAM;CAG5B;AAED,MAAM,MAAM,sBAAsB,GAAG,IAAI,GAAG,UAAU,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAE9F,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,6BAA6B,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjG,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAwGD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC7C,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC5C,GAAG,MAAM,CAWT;AA2ID,2EAA2E;AAC3E,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgExG"}

package/dist/activity/timeline/build.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Deterministic timeline-card day builder (issue #2049).
+ *
+ * Semantics (all half-open [start, end), all UTC internally):
+ * - Observations are grouped per capture machine and sorted by
+ *   (canonical capture instant, contentHash) — never by array position.
+ * - Compatibility rule: two consecutive observations on one machine merge
+ *   into the same card iff they share the exact (app, windowTitle) pair.
+ * - Gap rule: a merge happens only when the inter-observation gap is
+ *   ≤ MERGE_GAP_MS (2 min). A card's end extends from its last observation
+ *   by at most MAX_DWELL_MS (15 min, matching the digest dwell cap), is
+ *   clipped by the next observation on the machine, by any user pause, and
+ *   by the local day end — so cards never overlap on a track.
+ * - Idle: any uncovered remainder between consecutive cards on a machine
+ *   track (which in practice means a gap > MAX_DWELL_MS) becomes a derived
+ *   idle card with no evidence. The day's leading/trailing uncovered ranges
+ *   are represented by the absence of cards, not by invented idle.
+ * - Pause: user-declared intervals are unioned, clipped to the day, emitted
+ *   as pause cards, and never overlapped by activity dwell or idle.
+ * - Nothing is invented for gaps: idle/pause cards carry no evidence and are
+ *   flagged by kind; an app/window match never claims user intent.
+ *
+ * Output is byte-stable: identical inputs produce identical
+ * `serializeTimelineDay()` bytes across runs and process restarts.
+ */
+import type { TimelineCategory, TimelineDay, TimelineObservation, TimelinePause } from "./types.js";
+export declare const TIMELINE_FORMAT_VERSION = 1;
+/** Max inter-observation gap that still merges into one card. */
+export declare const TIMELINE_MERGE_GAP_MS = 120000;
+/** Max dwell attributed past a card's last observation (digest parity). */
+export declare const TIMELINE_MAX_DWELL_MS: number;
+export interface TimelineBuildInput {
+    /** Local day, YYYY-MM-DD. */
+    date: string;
+    timezone: string;
+    /** Stored observations for the day (e.g. from ActivityStore.listSnapshotsForDay). */
+    observations: readonly TimelineObservation[];
+    /** User-declared pauses (UTC, half-open); may overlap and extend past the day. */
+    pauses?: readonly TimelinePause[];
+    /** Registry override; validated. Defaults to the built-in registry. */
+    categories?: readonly TimelineCategory[];
+}
+/** Build one replayable local day of timeline cards. Pure; throws on bad input. */
+export declare function buildTimelineDay(input: TimelineBuildInput): TimelineDay;
+/**
+ * Canonical byte-stable serialization. Card objects are constructed in a
+ * fixed field order, so `JSON.stringify` output is stable across runs.
+ */
+export declare function serializeTimelineDay(day: TimelineDay): string;
+//# sourceMappingURL=build.d.ts.map

package/dist/activity/timeline/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH,OAAO,KAAK,EAAgB,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAElH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,SAAU,CAAC;AAC7C,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC7C,kFAAkF;IAClF,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,uEAAuE;IACvE,UAAU,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC1C;AAiFD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,WAAW,CA0IvE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE7D"}

package/dist/activity/timeline/categories.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Timeline category registry (issue #2049): ordered definitions with stable
+ * IDs, names, colors, descriptions, and system/idle flags. Reserved system
+ * categories (`system.*`) must always be present; unknown activity stays
+ * visible in `system.unknown` rather than being silently reassigned.
+ */
+import type { TimelineCategory } from "./types.js";
+export declare const TIMELINE_RESERVED_UNKNOWN = "system.unknown";
+export declare const TIMELINE_RESERVED_IDLE = "system.idle";
+export declare const TIMELINE_RESERVED_PAUSE = "system.pause";
+/**
+ * Default registry. User category orders step by 10 so a corrected registry
+ * can insert between without renumbering; system categories sort last.
+ */
+export declare const DEFAULT_TIMELINE_CATEGORIES: readonly TimelineCategory[];
+/**
+ * Validate a registry: unique well-formed ids, non-empty names, hex colors,
+ * integer orders, reserved categories present and correctly flagged, and the
+ * `system.` namespace reserved. Throws with the offending key path.
+ */
+export declare function validateTimelineCategories(categories: readonly TimelineCategory[]): void;
+/**
+ * Deterministic presentation order: by `order`, then by id as the equal-order
+ * tie-breaker, so two categories sharing an order never swap between runs.
+ */
+export declare function sortTimelineCategories(categories: readonly TimelineCategory[]): TimelineCategory[];
+//# sourceMappingURL=categories.d.ts.map

package/dist/activity/timeline/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/categories.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,yBAAyB,mBAAmB,CAAC;AAC1D,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AACpD,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAqBtD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,gBAAgB,EAYlE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CA+CxF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAElG"}

package/dist/activity/timeline/classify.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Deterministic first-pass timeline classification (issue #2049).
+ *
+ * Signal-only: application name, browser domain, and window-title keywords.
+ * No LLM, no scoring, no intent inference — an app/window match says what was
+ * on screen, never that the user meant it. First matching rule (in declared
+ * order: domain, then app, then title) wins; no match stays visible in the
+ * reserved `system.unknown` category with confidence 0.
+ */
+import type { TimelineCategory, TimelineObservation } from "./types.js";
+export interface TimelineClassification {
+    categoryId: string;
+    confidence: number;
+}
+/**
+ * Classify one observation. Throws if a rule targets a category missing from
+ * the registry (configuration error must fail loudly, not fall back silently).
+ */
+export declare function classifyTimelineObservation(observation: Pick<TimelineObservation, "app" | "windowTitle" | "browserUrl">, categories: readonly TimelineCategory[]): TimelineClassification;
+//# sourceMappingURL=classify.d.ts.map

package/dist/activity/timeline/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA8CxE,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,aAAa,GAAG,YAAY,CAAC,EAC5E,UAAU,EAAE,SAAS,gBAAgB,EAAE,GACtC,sBAAsB,CAoBxB"}

package/dist/activity/timeline/corrections.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Timeline correction store (issue #2049): manual card/category edits that
+ * survive day rebuilds. Corrections are keyed by the card's stable
+ * content-derived id, so rebuilding the same evidence reproduces the same
+ * card ids and re-applies the edit; an explicit `reset()` reverts a card to
+ * its derived values. Corrections are user edits, not evidence — they live in
+ * their own small SQLite file, never in the #1899 snapshot store.
+ */
+import { type BetterSqlite3Database } from "../../runtime/better-sqlite.js";
+import type { TimelineCard, TimelineCategory, TimelineCorrection } from "./types.js";
+export declare function timelineCorrectionDatabasePath(memoryDir: string): string;
+export declare class TimelineCorrectionStore {
+    private readonly db;
+    constructor(db: BetterSqlite3Database);
+    static open(memoryDir: string): TimelineCorrectionStore;
+    /**
+     * Persist one correction. `categoryId`, when set, must exist in `categories`
+     * (defaults to the built-in registry) — an unknown category is a malformed
+     * edit and must fail rather than silently strand the card.
+     */
+    upsert(correction: TimelineCorrection, categories?: readonly TimelineCategory[]): void;
+    get(cardId: string): TimelineCorrection | undefined;
+    /** All corrections ordered by card id (deterministic listing). */
+    list(): TimelineCorrection[];
+    /** Explicitly reset a card to its derived values; true when a correction existed. */
+    reset(cardId: string): boolean;
+    close(): void;
+}
+/** Corrections whose cardId is in `cards`, in incoming list order. */
+export declare function correctionsForCards(cards: readonly TimelineCard[], corrections: readonly TimelineCorrection[]): TimelineCorrection[];
+/**
+ * Apply corrections to built cards. Overrides title/category, sets confidence
+ * to 1 (a human confirmed it), and stamps manual-edit provenance. Uncorrected
+ * cards pass through untouched, so serialization stays byte-stable for them.
+ */
+export declare function applyTimelineCorrections(cards: readonly TimelineCard[], corrections: readonly TimelineCorrection[]): TimelineCard[];
+//# sourceMappingURL=corrections.d.ts.map

package/dist/activity/timeline/corrections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrections.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/corrections.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAqB,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE/F,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErF,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAkBD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwB;gBAE/B,EAAE,EAAE,qBAAqB;IAIrC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB;IAgBvD;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,kBAAkB,EAAE,UAAU,GAAE,SAAS,gBAAgB,EAAgC,GAAG,IAAI;IAuBnH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAKnD,kEAAkE;IAClE,IAAI,IAAI,kBAAkB,EAAE;IAO5B,qFAAqF;IACrF,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI9B,KAAK,IAAI,IAAI;CAGd;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,kBAAkB,EAAE,CAGtB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,YAAY,EAAE,CA0BhB"}

package/dist/activity/timeline/index.d.ts

@@ -0,0 +1,35 @@
+/** Public entry for the timeline-card layer (issue #2049). */
+export * from "./types.js";
+export * from "./categories.js";
+export * from "./classify.js";
+export * from "./build.js";
+export * from "./corrections.js";
+export * from "./query.js";
+export * from "./journal-recap.js";
+export * from "./journal-recap-persist.js";
+export * from "./weekly.js";
+export * from "./weekly-persist.js";
+export * from "./analysis.js";
+export * from "./analysis-provider.js";
+export * from "./analysis-run.js";
+export * from "./regenerate.js";
+export * from "./recap-export.js";
+export * from "./recap-export-range.js";
+export * from "./recap-markdown.js";
+export * from "./week-export.js";
+export * from "./week-snapshot.js";
+export * from "./week-dashboard.js";
+export * from "./week-previous.js";
+export * from "./week-recurring.js";
+export * from "./week-config-hash.js";
+export * from "./analysis-batch.js";
+export * from "./analysis-evidence.js";
+export * from "./analysis-prompt.js";
+export * from "./analysis-claim.js";
+export * from "./analysis-order.js";
+export * from "./recap-window.js";
+export * from "./analysis-failure.js";
+export * from "./recap-merge-edits.js";
+export * from "./analysis-metadata.js";
+export * from "./recap-fallback.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/activity/timeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/activity/timeline/journal-recap-persist.d.ts

@@ -0,0 +1,14 @@
+import type { TimelineCard } from "./types.js";
+export interface PersistDeterministicJournalInput {
+    memoryDir: string;
+    date: string;
+    cards: readonly TimelineCard[];
+    timezone: string;
+    force?: boolean;
+}
+export interface PersistDeterministicJournalResult {
+    path: string;
+    wrote: boolean;
+}
+export declare function persistDeterministicJournal(input: PersistDeterministicJournalInput): PersistDeterministicJournalResult;
+//# sourceMappingURL=journal-recap-persist.d.ts.map

package/dist/activity/timeline/journal-recap-persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-recap-persist.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/journal-recap-persist.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,iCAAiC,CAWnC"}

package/dist/activity/timeline/journal-recap.d.ts

@@ -0,0 +1,21 @@
+import type { TimelineCardKind } from "./types.js";
+/**
+ * Minimal card shape the renderer reads. `TimelineCard` is assignable, and
+ * so is the privacy-projected export card whose `title` is stripped
+ * (issue #2051): a title-less card renders its stable id instead.
+ */
+export interface JournalRenderCard {
+    id: string;
+    kind: TimelineCardKind;
+    title?: string;
+    categoryId: string;
+    startUtc: string;
+    endUtc: string;
+}
+export interface DeterministicJournalOptions {
+    date: string;
+    timezone: string;
+}
+/** Render a byte-stable Markdown journal for one local day. */
+export declare function renderDeterministicJournal(cards: readonly JournalRenderCard[], options: DeterministicJournalOptions): string;
+//# sourceMappingURL=journal-recap.d.ts.map

package/dist/activity/timeline/journal-recap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-recap.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/journal-recap.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AA8ED,+DAA+D;AAC/D,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,OAAO,EAAE,2BAA2B,GACnC,MAAM,CAkCR"}

package/dist/activity/timeline/publish-cli.d.ts

@@ -0,0 +1,17 @@
+import type { PluginConfig } from "../../types.js";
+export interface TimelinePublishIo {
+    stdout: {
+        write(chunk: string): unknown;
+    };
+    stderr: {
+        write(chunk: string): unknown;
+    };
+}
+export interface TimelinePublishOptions {
+    date?: unknown;
+    week?: unknown;
+    what?: unknown;
+    dryRun?: unknown;
+}
+export declare function runTimelinePublishCli(config: PluginConfig, options: TimelinePublishOptions, io: TimelinePublishIo): number;
+//# sourceMappingURL=publish-cli.d.ts.map

package/dist/activity/timeline/publish-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-cli.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/publish-cli.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,sBAAsB,EAC/B,EAAE,EAAE,iBAAiB,GACpB,MAAM,CAuFR"}

package/dist/activity/timeline/query.d.ts

@@ -0,0 +1,86 @@
+import type { PluginConfig } from "../../types.js";
+import type { ActivityTimelineQaConfig } from "../types.js";
+import type { TimelineCard } from "./types.js";
+declare const RANGE_FORMATS: readonly ["cards", "compact"];
+export type TimelineRangeFormat = (typeof RANGE_FORMATS)[number];
+/** Card fields the query layer reads; later slices may add optional extras. */
+export type TimelineQueryCard = TimelineCard & {
+    detailedSummary?: string;
+    distraction?: boolean;
+};
+export interface TimelineRangeQuery {
+    from: string;
+    to: string;
+    categories?: readonly string[];
+    includeDistractions?: boolean;
+    format: TimelineRangeFormat;
+    maxRangeDays?: number;
+}
+export interface TimelineCompactCard {
+    start: string;
+    end: string;
+    category: string;
+    title: string;
+    summary: string;
+}
+export interface TimelineCompactRange {
+    day: string;
+    cards: TimelineCompactCard[];
+}
+export interface TimelineSearchQuery {
+    query: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+}
+export type TimelineSearchResult = {
+    ok: true;
+    results: TimelineQueryCard[];
+} | {
+    ok: false;
+    error: "store_unreadable";
+};
+export interface TimelineCliIo {
+    stdout: {
+        write(chunk: string): unknown;
+    };
+    stderr: {
+        write(chunk: string): unknown;
+    };
+}
+/** Inject cards so CLI tests never need ActivityStore. */
+export interface TimelineCliDeps {
+    cards: readonly TimelineQueryCard[] | null;
+    qa: ActivityTimelineQaConfig;
+    timelineEnabled?: boolean;
+    /** Required for `publish`; range/search never read it. */
+    config?: PluginConfig;
+    /** Production host loads cards through regenerateTimelineDay. */
+    loadCards?: (window: {
+        from?: string;
+        to?: string;
+    }) => Promise<readonly TimelineQueryCard[] | null>;
+}
+/**
+ * Validate a range request completely - format, instants, ordering, and
+ * qa.maxRangeDays - with no card access. Production callers must run this
+ * before any side-effecting card loader so an invalid range fails before
+ * day regeneration or analysis spend.
+ */
+export declare function validateTimelineRangeQuery(query: {
+    from: string;
+    to: string;
+    format: string;
+    maxRangeDays?: number;
+}): void;
+/** Validate optional search bounds the way queryTimelineSearch applies them. */
+export declare function validateTimelineSearchBounds(bounds: {
+    from?: string;
+    to?: string;
+}): void;
+export declare function queryTimelineRange(cards: readonly TimelineQueryCard[], query: TimelineRangeQuery): TimelineCard[] | TimelineCompactRange;
+export declare function queryTimelineSearch(cards: readonly TimelineQueryCard[] | null | undefined, query: TimelineSearchQuery): TimelineSearchResult;
+/** Shared CLI runner. `deps.cards` may be an in-memory fixture. */
+export declare function runTimelineCliCommand(deps: TimelineCliDeps, args: string[], io: TimelineCliIo): Promise<number>;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/activity/timeline/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/query.ts"],"names":[],"mappings":"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"}

package/dist/activity/timeline/recap-card-count.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Recap card counter (issue #2051 leftover).
+ *
+ * Unique ids after dropping empty strings. Does not mutate input.
+ */
+export declare function countRecapCards(cards: readonly string[]): number;
+//# sourceMappingURL=recap-card-count.d.ts.map

package/dist/activity/timeline/recap-card-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recap-card-count.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/recap-card-count.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMhE"}

package/dist/activity/timeline/recap-card-id.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse a recap card id (issue #2051 leftover).
+ *
+ * Pure. Empty is missing_id. Newline is invalid_id.
+ */
+export type ParseRecapCardIdResult = {
+    ok: true;
+    id: string;
+} | {
+    ok: false;
+    error: "missing_id" | "invalid_id";
+};
+export declare function parseRecapCardId(value: string): ParseRecapCardIdResult;
+//# sourceMappingURL=recap-card-id.d.ts.map

package/dist/activity/timeline/recap-card-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recap-card-id.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/recap-card-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAAA;CAAE,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAKtE"}

package/dist/activity/timeline/recap-date.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse a recap local-day string (issue #2051 leftover).
+ *
+ * Trim first. Empty → missing_date. Bounded YYYY-MM-DD only (no ReDoS).
+ */
+export type RecapDateResult = {
+    ok: true;
+    date: string;
+} | {
+    ok: false;
+    error: "missing_date" | "invalid_date";
+};
+/** Trim and accept YYYY-MM-DD, or return a typed error. */
+export declare function parseRecapDate(value: string): RecapDateResult;
+//# sourceMappingURL=recap-date.d.ts.map

package/dist/activity/timeline/recap-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recap-date.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/recap-date.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAAA;CAAE,CAAC;AAI1D,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAK7D"}

package/dist/activity/timeline/recap-empty.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Empty-set guard for timeline recap cards (issue #2051 leftover).
+ *
+ * null, undefined, and [] are empty. A non-array throws. Any other array is not empty.
+ */
+/** True when the recap card list is absent or has no items. */
+export declare function isEmptyRecapCards(cards: unknown): boolean;
+//# sourceMappingURL=recap-empty.d.ts.map

package/dist/activity/timeline/recap-empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recap-empty.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/recap-empty.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD"}

package/dist/activity/timeline/recap-export-range.d.ts

@@ -0,0 +1,55 @@
+import { type RecapExportCard } from "./recap-export.js";
+import type { TimelineCard } from "./types.js";
+export declare const DEFAULT_RECAP_RANGE_MAX_DAYS = 366;
+export interface DeterministicRecapRangeOptions {
+    /** Inclusive first local day, YYYY-MM-DD. */
+    startDate: string;
+    /** Inclusive last local day, YYYY-MM-DD. */
+    endDate: string;
+    timezone: string;
+    cards: readonly TimelineCard[];
+    /** Include observation-derived card content (`title`). Default false. */
+    includeObservations?: boolean;
+    /** Hard upper bound on exported days; default 366. */
+    maxDays?: number;
+}
+export interface DeterministicRecapDay {
+    date: string;
+    timezone: string;
+    cards: RecapExportCard[];
+}
+export interface DeterministicRecapRange {
+    startDate: string;
+    endDate: string;
+    timezone: string;
+    days: DeterministicRecapDay[];
+}
+export type DeterministicRecapRangeResult = {
+    ok: true;
+    range: DeterministicRecapRange;
+} | {
+    ok: false;
+    error: "invalid_start_date" | "invalid_end_date" | "end_before_start" | "range_too_large";
+    /** The enforced day bound, present on range_too_large. */
+    limit?: number;
+};
+export type DeterministicRecapRangeMarkdownResult = {
+    ok: true;
+    markdown: string;
+    dayCount: number;
+} | Extract<DeterministicRecapRangeResult, {
+    ok: false;
+}>;
+/**
+ * Build the byte-stable JSON recap document for an inclusive local-day
+ * range. Day entries are ascending; day cards are sorted by id; per-card
+ * key order is fixed by `projectCardForRecapExport`.
+ */
+export declare function exportDeterministicRecapRange(options: DeterministicRecapRangeOptions): DeterministicRecapRangeResult;
+/**
+ * Render the byte-stable Markdown recap for an inclusive local-day range:
+ * one `renderDeterministicJournal` section per day, ascending. Validation
+ * and bounds match `exportDeterministicRecapRange`.
+ */
+export declare function renderDeterministicJournalRange(options: DeterministicRecapRangeOptions): DeterministicRecapRangeMarkdownResult;
+//# sourceMappingURL=recap-export-range.d.ts.map

package/dist/activity/timeline/recap-export-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recap-export-range.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/recap-export-range.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,MAAM,WAAW,8BAA8B;IAC7C,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,qBAAqB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,GAC5C;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EACD,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,CAAC;IACtB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,qCAAqC,GAC7C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,6BAA6B,EAAE;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AA0B1D;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CA+C/B;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,8BAA8B,GACtC,qCAAqC,CAcvC"}

package/dist/activity/timeline/recap-export.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Deterministic machine-readable recap export from timeline cards (issue #2051).
+ *
+ * Pure: cards + date + timezone in, stable JSON out. No LLM, no I/O, no
+ * persistence. Same cards always serialize to the same bytes, regardless of
+ * input array order: cards are sorted by id before serialization.
+ *
+ * Privacy boundary (issue #2053 policy): a card `title` is captured
+ * observation content (the source window title). It is excluded unless the
+ * export explicitly permits observations — the same default as
+ * `activity.exportIncludeObservations`. Evidence references (store row ids,
+ * identity hashes) are always kept: they point at content without copying it.
+ */
+import type { TimelineCard } from "./types.js";
+export interface DeterministicRecapOptions {
+    date: string;
+    timezone: string;
+    cards: readonly TimelineCard[];
+    /**
+     * Include observation-derived card content (`title`). Default false,
+     * matching the `activity.exportIncludeObservations` policy default.
+     */
+    includeObservations?: boolean;
+}
+/** Card projected for export: `title` present only when the policy permits. */
+export interface RecapExportCard extends Omit<TimelineCard, "title"> {
+    title?: string;
+}
+export interface DeterministicRecap {
+    date: string;
+    timezone: string;
+    cards: RecapExportCard[];
+}
+/**
+ * Project one card for export with a fixed key order. Observation-derived
+ * `title` is dropped unless `includeObservations`; user-authored provenance
+ * (manual edits, pause reasons inside `summary`) stays, and evidence
+ * references always stay.
+ */
+export declare function projectCardForRecapExport(card: TimelineCard, includeObservations: boolean): RecapExportCard;
+/**
+ * Build the byte-stable JSON recap document for one local day.
+ * Callers may `JSON.stringify` the returned object; construction order
+ * (date, timezone, cards, and the per-card key order) is fixed, so
+ * serialization is deterministic.
+ */
+export declare function exportDeterministicRecap(options: DeterministicRecapOptions): DeterministicRecap;
+//# sourceMappingURL=recap-export.d.ts.map

package/dist/activity/timeline/recap-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recap-export.d.ts","sourceRoot":"","sources":["../../../src/activity/timeline/recap-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,YAAY,EAClB,mBAAmB,EAAE,OAAO,GAC3B,eAAe,CAsBjB;AAQD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CASpB"}