@remnic/core 9.10.0 → 9.12.0

package/dist/index.d.ts

@@ -87,6 +87,7 @@ export { EnrichmentAuditEntry, EnrichmentCandidate, EnrichmentCostTier, Enrichme
 export { clearBulkImportSources, getBulkImportSource, listBulkImportSources, registerBulkImportSource } from './bulk-import/index.js';
 export { a as ProcessBatchContext, P as ProcessBatchFn, b as ProcessBatchResult, f as formatBatchTranscript, r as resolveBulkImportContext, c as runBulkImportPipeline, v as validateBatchSize } from './pipeline-Cn-kvYeV.js';
 export { B as BulkImportCliCommandOptions, p as parseStrictCliDate, r as runBulkImportCliCommand } from './cli-5tNLVTvJ.js';
+import { BetterSqlite3Database } from './runtime/better-sqlite.js';
 export { DEFAULT_IMPORT_BATCH_SIZE, ImportProgress, ImportedMemory, ImporterAdapter, ImporterParseOptions, ImporterTransformOptions, ImporterWriteResult, ImporterWriteTarget, RunImportOptions, RunImporterResult, defaultWriteMemoriesToOrchestrator, importedMemoryToTurn, runImporter, validateImportBatchSize, validateImportRateLimit } from './importers/index.js';
 export { FallbackLlmClient, FallbackLlmOptions, FallbackLlmResponse, FallbackLlmRuntimeContext } from './fallback-llm.js';
 export { ComputeMemoryWorthInput, MemoryWorthResult, computeMemoryWorth } from './memory-worth.js';
@@ -121,7 +122,6 @@ import './namespaces/search.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';
 import './maintenance/memory-governance.js';
-import './runtime/better-sqlite.js';
 import 'better-sqlite3';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -6818,6 +6818,158 @@ interface WearablesCliIo {
  */
 declare function runWearablesCliCommand(service: WearablesService, args: string[], io: WearablesCliIo): Promise<number>;
 
+/**
+ * Screen-activity subsystem — shared types (issue #1899).
+ *
+ * A third ingestion modality alongside wearables (conversations) and live
+ * connectors (documents). Screen text has no speakers and is high-volume, so it
+ * gets its own store and day-digest rather than being forced into the wearable
+ * conversation shape. Capture daemons live in the à-la-carte `@remnic/capture-screen`
+ * package; this core subsystem is host-agnostic and consumes snapshots over a
+ * loopback HTTP client.
+ *
+ * All timestamps are UTC ISO-8601; day bucketing is half-open [start, end).
+ */
+/** One captured on-screen text snapshot (a single window at a single instant). */
+interface ActivitySnapshot {
+    /** Store row id (assigned on insert; absent before persistence). */
+    id?: number;
+    /** Capture-machine label (disambiguates multi-machine stores). */
+    machine: string;
+    /** UTC ISO-8601 capture instant. */
+    capturedAtUtc: string;
+    /** Frontmost application name. */
+    app: string;
+    /** Frontmost window title. */
+    windowTitle: string;
+    /** Browser tab URL, when the frontmost window is a known browser. */
+    browserUrl?: string;
+    /** Extracted visible text (accessibility tree or OCR). */
+    text: string;
+    /** Where the text came from. */
+    textSource: "ax" | "ocr";
+    /** SHA-256 of the normalized snapshot content (idempotency key). */
+    contentHash: string;
+    /** 64-bit SimHash (hex) for near-duplicate detection, when computed. */
+    simhash?: string;
+}
+/** Frontmatter persisted on a rendered day digest. */
+interface ActivityDayMeta {
+    kind: "activity-digest";
+    /** Local day, YYYY-MM-DD. */
+    date: string;
+    /** Machines that contributed snapshots, sorted. */
+    machines: string[];
+    snapshotCount: number;
+    /** SHA-256 of the rendered body (rebuild-idempotency). */
+    contentHash: string;
+    formatVersion: number;
+}
+/** A parsed day digest (frontmatter + rendered body). */
+interface ActivityDayDigest {
+    meta: ActivityDayMeta;
+    body: string;
+}
+/** Result of a capture-daemon auth/health probe. */
+interface ActivitySourceCheck {
+    ok: boolean;
+    detail?: string;
+}
+/** One page of snapshots pulled from a capture daemon. */
+interface ActivitySnapshotPage {
+    snapshots: ActivitySnapshot[];
+    nextCursor: string | null;
+}
+/**
+ * Client contract for a screen-capture daemon (one per capture machine).
+ * Implemented by a later slice (the HTTP source client); defined here so the
+ * store and pipeline can be built and tested against a fixture double first.
+ */
+interface ActivitySourceClient {
+    /** Stable capture-machine label. */
+    machineLabel: string;
+    /** Probe connectivity/auth without mutating anything. */
+    verify(signal?: AbortSignal): Promise<ActivitySourceCheck>;
+    /** Fetch one page of snapshots for a single local day. */
+    fetchSnapshots(opts: {
+        date: string;
+        timezone: string;
+        cursor?: string | null;
+        signal?: AbortSignal;
+    }): Promise<ActivitySnapshotPage>;
+}
+
+/**
+ * Screen-activity SQLite store (issue #1899).
+ *
+ * Durable, capture-machine-agnostic store for on-screen text snapshots plus a
+ * per-machine sync cursor. Mirrors the LCM store conventions
+ * (packages/remnic-core/src/lcm/schema.ts): WAL, a `<name>_meta` schema-version
+ * row, `CREATE TABLE IF NOT EXISTS`, and an FTS5 virtual table created
+ * separately. better-sqlite3 is synchronous.
+ *
+ * Snapshots dedup on `(machine, content_hash)` so a re-sync is idempotent, and
+ * day queries use half-open [start, end) UTC bounds (AGENTS.md §23).
+ */
+
+declare function activityDatabasePath(memoryDir: string): string;
+declare function ensureActivityStateDir(memoryDir: string): Promise<void>;
+declare function openActivityDatabase(memoryDir: string): BetterSqlite3Database;
+/** Apply the activity schema on an already-open handle (test/in-memory use). */
+declare function applyActivitySchema(db: BetterSqlite3Database): void;
+declare class ActivityStore {
+    private readonly db;
+    constructor(db: BetterSqlite3Database);
+    static open(memoryDir: string): ActivityStore;
+    /**
+     * Insert a snapshot, idempotent on (machine, captured_at_utc, content_hash):
+     * the same screen content recurring at a *different* time is kept; only an
+     * exact re-ingestion of the same capture dedups. Returns `inserted: false`
+     * for a duplicate. The FTS row is written only on a real insert (atomically),
+     * so it never drifts from the base table.
+     */
+    insertSnapshot(snapshot: ActivitySnapshot): {
+        inserted: boolean;
+        id: number;
+    };
+    /** Snapshots whose capture instant is in the half-open [start, end) window. */
+    listSnapshotsForDay(machine: string | null, startUtcInclusive: string, endUtcExclusive: string): ActivitySnapshot[];
+    getCursor(machine: string): string | null;
+    setCursor(machine: string, cursor: string | null, updatedAtUtc?: string): void;
+    /** Full-text search over snapshot text/app/window/url; newest first. */
+    searchSnapshots(query: string, limit: number): ActivitySnapshot[];
+    /** Retention: drop snapshots captured strictly before `cutoffUtc`. */
+    pruneOlderThan(cutoffUtc: string): number;
+    close(): void;
+}
+
+/**
+ * Deterministic screen-activity day-digest renderer (issue #1899).
+ *
+ * Renders a day's snapshots into markdown with YAML frontmatter, placed at
+ * `<memoryDir>/activity/<date>.md` — outside the memory scan roots but inside
+ * the QMD collection root (searchable, never auto-recalled). No LLM: the body
+ * is a pure, byte-identical function of its inputs so an unchanged day skips
+ * rewrite by contentHash. Day bucketing is DST-aware and half-open
+ * [start, end) (AGENTS.md §23); sort keys are total with stable tiebreakers
+ * (§12).
+ */
+
+declare const ACTIVITY_DIGEST_FORMAT_VERSION = 1;
+declare const ACTIVITY_DIR_NAME = "activity";
+declare function isValidActivityDate(date: string): boolean;
+declare function activityDigestPath(memoryDir: string, date: string): string;
+/** Half-open [start, end) UTC ISO bounds of a local day. */
+declare function activityDayWindow(date: string, timezone: string): {
+    startUtc: string;
+    endUtc: string;
+};
+declare function composeActivityDigestBody(date: string, timezone: string, snapshots: ActivitySnapshot[]): string;
+declare function hashActivityBody(body: string): string;
+declare function composeActivityDigestMeta(date: string, machines: string[], snapshots: ActivitySnapshot[], body: string): ActivityDayMeta;
+declare function serializeActivityDigest(meta: ActivityDayMeta, body: string): string;
+declare function parseActivityDigest(raw: string): ActivityDayDigest | null;
+
 type LocalSessionRole = "user" | "assistant" | "tool" | "system" | "other";
 interface LocalSessionTurn {
     role: LocalSessionRole;
@@ -7134,4 +7286,4 @@ declare function forkCapsule(opts: ForkCapsuleOptions): Promise<ForkCapsuleResul
  */
 declare function readForkLineage(targetRoot: string, forkId: string): Promise<ForkLineage | null>;
 
-export { type ArchitectureHintsResult, type AuditEntry, type BinaryAssetRecord, type BinaryAssetStatus, type BinaryLifecycleConfig, type BinaryLifecycleManifest, type BinaryStorageBackend, type BinaryStorageBackendConfig, ClaudeCodeMemoryExtensionPublisher, type CleanupResult, CodexMemoryExtensionPublisher, type CodingNamespaceOverlay, type CodingScopeDescription, type CollectLocalSessionSummariesOptions, type CompiledCorrectionRule, type CompiledRedactionRule, type ConflictEntry, type ContradictionOptions, type ContradictionPair, type ContradictionResult$1 as CurateContradictionResult, type DuplicateResult as CurateDuplicateResult, type CurateOptions, type CurateResult, type CuratedStatement, DEFAULT_GRACE_PERIOD_DAYS, DEFAULT_MAX_BINARY_SIZE_BYTES, DEFAULT_PROXIMITY_GAP_MS, DEFAULT_REDACTION_RULES, DEFAULT_SCAN_PATTERNS, DEFAULT_SOURCE_TRUST, DEFAULT_TAXONOMY, DEFAULT_WINDOW_TOLERANCE_MS, type DedupOptions, type DedupResult, DiscoveredExtension, type DocFile, type DriveChange, type DriveChangesPage, type DriveFileMetadata, type DuplicatePair, EngramAccessService, type FileChange, FilesystemBackend, type ForkCapsuleOptions, type ForkCapsuleResult, type ForkLineage, type FuseClusterResult, FusedDisagreement, FusedSegment, FusedSpeaker, FusionConversationInput, FusionDayResult, FusionOptions, GOOGLE_DRIVE_CONNECTOR_ID, GOOGLE_DRIVE_CURSOR_KIND, DEFAULT_POLL_INTERVAL_MS as GOOGLE_DRIVE_DEFAULT_POLL_INTERVAL_MS, type GenerateOptions, type GenerateResult, type GitContext, type GitInvoker, type GoogleDriveClient, type GoogleDriveClientFactory, type GoogleDriveConnectorConfig, type GoogleDriveSyncResult, HermesMemoryExtensionPublisher, type IngestionPlan, KNOWN_WEARABLE_SOURCE_IDS, type LanguageInfo, LiveConnector, LiveConnectorRegistry, LiveConnectorRegistryError, type LocalSessionAdapterInput, type LocalSessionAdapterOptions, type LocalSessionParseWarning, type LocalSessionParsedFile, type LocalSessionRole, type LocalSessionSourceAdapter, type LocalSessionSummaryCliOptions, type LocalSessionSummaryReport, type LocalSessionTurn, MemoryCategory, type MemoryEntry, type MemoryExtensionPublisher, type MergeResult, NOTION_CONNECTOR_ID, NOTION_CURSOR_KIND, NOTION_DEFAULT_POLL_INTERVAL_MS, NoneBackend, type NotionConnectorConfig, type OnboardOptions, type OnboardResult, PUBLISHERS, type PackReviewContextStructuralInput, type PipelineResult, PluginConfig, type ProjectShape, type ProvenanceEntry, type PublishContext, type PublishResult, type PublisherCapabilities, REDACTION_PLACEHOLDER, RELAY_DEMO_MISSION_ID, RELAY_DEMO_NAMESPACE, RELAY_MISSION_DEFAULT_EVENT_LIMIT, RELAY_MISSION_MAX_EVENTS, RELAY_MISSION_MAX_EVENT_LIMIT, RELAY_MISSION_MAX_FILE_BYTES, RELAY_MISSION_MAX_LINE_BYTES, RELAY_MISSION_SCHEMA_VERSION, REMNIC_CITATION_FORMAT, REMNIC_MCP_TOOL_INVENTORY, REMNIC_RECALL_DECISION_RULES, REMNIC_SEMANTIC_OVERVIEW, type RedactionConfig, type RedactionReport, type RedactionRuleConfig, type RelayAgentOutputSnapshot, type RelayAgentSnapshot, type RelayConflictSnapshot, type RelayCorrectionSnapshot, type RelayDecisionSnapshot, type RelayEvidenceRef, RelayEvidenceRefSchema, type RelayMissionAppendAccessInput, type RelayMissionAppendAccessOutput, type RelayMissionAppendResult, type RelayMissionEvent, type RelayMissionEventInput, RelayMissionEventInputSchema, RelayMissionEventSchema, type RelayMissionPayload, RelayMissionPayloadSchema, type RelayMissionReadAccessInput, type RelayMissionReadAccessOutput, type RelayMissionReadOptions, RelayMissionReadOptionsSchema, type RelayMissionSnapshot, type RelayMissionStatus, RelayMissionStore, RelayMissionStoreError, type RelayMissionStoreErrorCode, type RelayMissionStoreOptions, type RelayPropagationSnapshot, type RelayRecallSnapshot, type RelayTestSnapshot, ResolverDecision, type ReviewAction, type ReviewCandidate, type ReviewContext, type ReviewItem, type ReviewListResult, type ReviewOptions, type ReviewResult, type SessionSummaryDraft, type SessionSummaryExcerpt, type Space, type SpaceKind, type SpaceManifest, type SpacePromoteResult, type SpacePullResult, type SpacePushResult, type SpaceShareResult, type SpaceSwitchResult, SpeakerRegistry, type StatementProvenance, StorageManager, type StructuralContextDegradation, type StructuralContextErrorCode, type StructuralContextProvider, type StructuralProviderStatus, type StructuralSpawnFn, type StructuralSymbol, type SubprocessProviderOptions, type SymbolsForDiffErr, type SymbolsForDiffOk, type SymbolsForDiffResult, SyncIncrementalResult, type SyncOptions, type SyncResult, type SyncState, TRANSCRIPT_FORMAT_VERSION, Taxonomy, TokenEntry, type TrainingExportAdapter, type TrainingExportOptions, type TrainingExportRecord, type TranscriptSegmentMatch, type TreeNode, WEARABLES_DIR_NAME, WearableCleanupSettings, type WearableConnectorFactory, type WearableConnectorFactoryOptions, type WearableConnectorRegistration, WearableConversation, WearableCorrectionRule, WearableDayTranscript, WearableDayTranscriptMeta, WearableFusionConfig, WearableSourceConnector, WearableSourceSettings, type WearableSourceSyncState, type WearableSyncStateFile, type WearablesCliIo, WearablesConfig, WearablesInputError, WearablesService, appendRelayMissionEvent, applyCorrections, applyOffTheRecord, bodyIsEscaped, branchNamespaceName, buildProcedureMarkdownBody, buildProcedureRecallSection, cleanConversation, clearStructuralContextProvidersForTest, clearTrainingExportAdapters, clearWearableConnectors, clusterConversations, collapseImmediateRepeats, collectLocalSessionSummaries, compareRelayEvents, compileCorrectionRule, compileCorrectionRules, compileRedactionPatterns, compileRedactionRules, composeDayTranscriptBody, composeDayTranscriptMeta, convertMemoriesToRecords, correctionsFilePath, createBackend, createGoogleDriveConnector, createNotionConnector, createRelayMissionFixture, createSpace, createSubprocessStructuralProvider, curate, decodeTranscriptBody, defaultGoogleDriveClientFactory, defaultWearableCleanupSettings, defaultWearableFusionConfig, defaultWearableSourceSettings, defaultWearablesConfig, deleteSpace, describeCodingScope, describeErrorForOperator, describeStructuralProviderStatus, emptyManifest, emptySyncState, ensureBuiltInWearableConnectors, escapeSegmentText, findContradictions, findDuplicates, forkCapsule, fuseCluster, fuseDay, fusionInputsFromConversations, generateContextTree, generateResolverDocument, getActiveSpace, getAuditLog, getLocalSessionSourceAdapter, getManifestPath, getSpacesDir, getStructuralContextProvider, getTaxonomyDir, getTaxonomyFilePath, getTrainingExportAdapter, getWearableConnector, hashTranscriptBody, hostIdForConnector, isLowQualitySegment, isReviewPrompt, isValidTranscriptDate, listLocalSessionSourceAdapters, listReviewItems, listSpaces, listTrainingExportAdapters, listWearableConnectors, loadCorrectionsFile, loadManifest, loadSyncState, loadTaxonomy, manifestDir, manifestPath, matchesPatterns, mergeSpaces, normalizeOriginUrl, onboard, packReviewContext, packReviewContextStructural, parseDayTranscript, parseFlexibleIsoTimestamp, parseIsoOffsetTimestamp, parseIsoUtcTimestamp, parseProcedureStepsFromBody, parseTouchedFiles, parseTranscriptSegmentLine, parseWearablesConfig, performReview, probeStructuralProviderForDoctor, projectNamespaceName, promoteSpace, publisherFor, publisherForConnector, pullFromSpace, pushToSpace, rankReviewCandidates, readForkLineage, readManifest, readRelayMission, reconstructFusionInputs, redactSessionSummaryText, redactText, reduceRelayMission, registerLocalSessionSourceAdapter, registerPublisher, registerStructuralContextProvider, registerTrainingExportAdapter, registerWearableConnector, relayMissionAppendOperation, relayMissionReadOperation, relayMissionReceiptDigest, renderExtensionsBlock, renderExtensionsFooter, renderStructuralProviderStatusLine, resolveCategory, resolveCodingNamespaceOverlay, resolveGitContext, runBinaryLifecyclePipeline, runLocalSessionSummaryCliCommand, runWearablesCliCommand, saveCorrectionsFile, saveManifest, saveSyncState, saveTaxonomy, scanForBinaries, serializeDayTranscript, shareSpace, stableHash, stripFillerTokens, structuralProviderActive, switchSpace, syncChanges, syncStateFilePath, toStructuralContextDegradation, unescapeSegmentText, unescapeSpeakerLabel, updateSourceSyncState, validateGoogleDriveConfig, validateNotionConfig, validateSlug, validateTaxonomy, watchForChanges, writeManifest };
+export { ACTIVITY_DIGEST_FORMAT_VERSION, ACTIVITY_DIR_NAME, type ActivityDayDigest, type ActivityDayMeta, type ActivitySnapshot, type ActivitySnapshotPage, type ActivitySourceCheck, type ActivitySourceClient, ActivityStore, type ArchitectureHintsResult, type AuditEntry, type BinaryAssetRecord, type BinaryAssetStatus, type BinaryLifecycleConfig, type BinaryLifecycleManifest, type BinaryStorageBackend, type BinaryStorageBackendConfig, ClaudeCodeMemoryExtensionPublisher, type CleanupResult, CodexMemoryExtensionPublisher, type CodingNamespaceOverlay, type CodingScopeDescription, type CollectLocalSessionSummariesOptions, type CompiledCorrectionRule, type CompiledRedactionRule, type ConflictEntry, type ContradictionOptions, type ContradictionPair, type ContradictionResult$1 as CurateContradictionResult, type DuplicateResult as CurateDuplicateResult, type CurateOptions, type CurateResult, type CuratedStatement, DEFAULT_GRACE_PERIOD_DAYS, DEFAULT_MAX_BINARY_SIZE_BYTES, DEFAULT_PROXIMITY_GAP_MS, DEFAULT_REDACTION_RULES, DEFAULT_SCAN_PATTERNS, DEFAULT_SOURCE_TRUST, DEFAULT_TAXONOMY, DEFAULT_WINDOW_TOLERANCE_MS, type DedupOptions, type DedupResult, DiscoveredExtension, type DocFile, type DriveChange, type DriveChangesPage, type DriveFileMetadata, type DuplicatePair, EngramAccessService, type FileChange, FilesystemBackend, type ForkCapsuleOptions, type ForkCapsuleResult, type ForkLineage, type FuseClusterResult, FusedDisagreement, FusedSegment, FusedSpeaker, FusionConversationInput, FusionDayResult, FusionOptions, GOOGLE_DRIVE_CONNECTOR_ID, GOOGLE_DRIVE_CURSOR_KIND, DEFAULT_POLL_INTERVAL_MS as GOOGLE_DRIVE_DEFAULT_POLL_INTERVAL_MS, type GenerateOptions, type GenerateResult, type GitContext, type GitInvoker, type GoogleDriveClient, type GoogleDriveClientFactory, type GoogleDriveConnectorConfig, type GoogleDriveSyncResult, HermesMemoryExtensionPublisher, type IngestionPlan, KNOWN_WEARABLE_SOURCE_IDS, type LanguageInfo, LiveConnector, LiveConnectorRegistry, LiveConnectorRegistryError, type LocalSessionAdapterInput, type LocalSessionAdapterOptions, type LocalSessionParseWarning, type LocalSessionParsedFile, type LocalSessionRole, type LocalSessionSourceAdapter, type LocalSessionSummaryCliOptions, type LocalSessionSummaryReport, type LocalSessionTurn, MemoryCategory, type MemoryEntry, type MemoryExtensionPublisher, type MergeResult, NOTION_CONNECTOR_ID, NOTION_CURSOR_KIND, NOTION_DEFAULT_POLL_INTERVAL_MS, NoneBackend, type NotionConnectorConfig, type OnboardOptions, type OnboardResult, PUBLISHERS, type PackReviewContextStructuralInput, type PipelineResult, PluginConfig, type ProjectShape, type ProvenanceEntry, type PublishContext, type PublishResult, type PublisherCapabilities, REDACTION_PLACEHOLDER, RELAY_DEMO_MISSION_ID, RELAY_DEMO_NAMESPACE, RELAY_MISSION_DEFAULT_EVENT_LIMIT, RELAY_MISSION_MAX_EVENTS, RELAY_MISSION_MAX_EVENT_LIMIT, RELAY_MISSION_MAX_FILE_BYTES, RELAY_MISSION_MAX_LINE_BYTES, RELAY_MISSION_SCHEMA_VERSION, REMNIC_CITATION_FORMAT, REMNIC_MCP_TOOL_INVENTORY, REMNIC_RECALL_DECISION_RULES, REMNIC_SEMANTIC_OVERVIEW, type RedactionConfig, type RedactionReport, type RedactionRuleConfig, type RelayAgentOutputSnapshot, type RelayAgentSnapshot, type RelayConflictSnapshot, type RelayCorrectionSnapshot, type RelayDecisionSnapshot, type RelayEvidenceRef, RelayEvidenceRefSchema, type RelayMissionAppendAccessInput, type RelayMissionAppendAccessOutput, type RelayMissionAppendResult, type RelayMissionEvent, type RelayMissionEventInput, RelayMissionEventInputSchema, RelayMissionEventSchema, type RelayMissionPayload, RelayMissionPayloadSchema, type RelayMissionReadAccessInput, type RelayMissionReadAccessOutput, type RelayMissionReadOptions, RelayMissionReadOptionsSchema, type RelayMissionSnapshot, type RelayMissionStatus, RelayMissionStore, RelayMissionStoreError, type RelayMissionStoreErrorCode, type RelayMissionStoreOptions, type RelayPropagationSnapshot, type RelayRecallSnapshot, type RelayTestSnapshot, ResolverDecision, type ReviewAction, type ReviewCandidate, type ReviewContext, type ReviewItem, type ReviewListResult, type ReviewOptions, type ReviewResult, type SessionSummaryDraft, type SessionSummaryExcerpt, type Space, type SpaceKind, type SpaceManifest, type SpacePromoteResult, type SpacePullResult, type SpacePushResult, type SpaceShareResult, type SpaceSwitchResult, SpeakerRegistry, type StatementProvenance, StorageManager, type StructuralContextDegradation, type StructuralContextErrorCode, type StructuralContextProvider, type StructuralProviderStatus, type StructuralSpawnFn, type StructuralSymbol, type SubprocessProviderOptions, type SymbolsForDiffErr, type SymbolsForDiffOk, type SymbolsForDiffResult, SyncIncrementalResult, type SyncOptions, type SyncResult, type SyncState, TRANSCRIPT_FORMAT_VERSION, Taxonomy, TokenEntry, type TrainingExportAdapter, type TrainingExportOptions, type TrainingExportRecord, type TranscriptSegmentMatch, type TreeNode, WEARABLES_DIR_NAME, WearableCleanupSettings, type WearableConnectorFactory, type WearableConnectorFactoryOptions, type WearableConnectorRegistration, WearableConversation, WearableCorrectionRule, WearableDayTranscript, WearableDayTranscriptMeta, WearableFusionConfig, WearableSourceConnector, WearableSourceSettings, type WearableSourceSyncState, type WearableSyncStateFile, type WearablesCliIo, WearablesConfig, WearablesInputError, WearablesService, activityDatabasePath, activityDayWindow, activityDigestPath, appendRelayMissionEvent, applyActivitySchema, applyCorrections, applyOffTheRecord, bodyIsEscaped, branchNamespaceName, buildProcedureMarkdownBody, buildProcedureRecallSection, cleanConversation, clearStructuralContextProvidersForTest, clearTrainingExportAdapters, clearWearableConnectors, clusterConversations, collapseImmediateRepeats, collectLocalSessionSummaries, compareRelayEvents, compileCorrectionRule, compileCorrectionRules, compileRedactionPatterns, compileRedactionRules, composeActivityDigestBody, composeActivityDigestMeta, composeDayTranscriptBody, composeDayTranscriptMeta, convertMemoriesToRecords, correctionsFilePath, createBackend, createGoogleDriveConnector, createNotionConnector, createRelayMissionFixture, createSpace, createSubprocessStructuralProvider, curate, decodeTranscriptBody, defaultGoogleDriveClientFactory, defaultWearableCleanupSettings, defaultWearableFusionConfig, defaultWearableSourceSettings, defaultWearablesConfig, deleteSpace, describeCodingScope, describeErrorForOperator, describeStructuralProviderStatus, emptyManifest, emptySyncState, ensureActivityStateDir, ensureBuiltInWearableConnectors, escapeSegmentText, findContradictions, findDuplicates, forkCapsule, fuseCluster, fuseDay, fusionInputsFromConversations, generateContextTree, generateResolverDocument, getActiveSpace, getAuditLog, getLocalSessionSourceAdapter, getManifestPath, getSpacesDir, getStructuralContextProvider, getTaxonomyDir, getTaxonomyFilePath, getTrainingExportAdapter, getWearableConnector, hashActivityBody, hashTranscriptBody, hostIdForConnector, isLowQualitySegment, isReviewPrompt, isValidActivityDate, isValidTranscriptDate, listLocalSessionSourceAdapters, listReviewItems, listSpaces, listTrainingExportAdapters, listWearableConnectors, loadCorrectionsFile, loadManifest, loadSyncState, loadTaxonomy, manifestDir, manifestPath, matchesPatterns, mergeSpaces, normalizeOriginUrl, onboard, openActivityDatabase, packReviewContext, packReviewContextStructural, parseActivityDigest, parseDayTranscript, parseFlexibleIsoTimestamp, parseIsoOffsetTimestamp, parseIsoUtcTimestamp, parseProcedureStepsFromBody, parseTouchedFiles, parseTranscriptSegmentLine, parseWearablesConfig, performReview, probeStructuralProviderForDoctor, projectNamespaceName, promoteSpace, publisherFor, publisherForConnector, pullFromSpace, pushToSpace, rankReviewCandidates, readForkLineage, readManifest, readRelayMission, reconstructFusionInputs, redactSessionSummaryText, redactText, reduceRelayMission, registerLocalSessionSourceAdapter, registerPublisher, registerStructuralContextProvider, registerTrainingExportAdapter, registerWearableConnector, relayMissionAppendOperation, relayMissionReadOperation, relayMissionReceiptDigest, renderExtensionsBlock, renderExtensionsFooter, renderStructuralProviderStatusLine, resolveCategory, resolveCodingNamespaceOverlay, resolveGitContext, runBinaryLifecyclePipeline, runLocalSessionSummaryCliCommand, runWearablesCliCommand, saveCorrectionsFile, saveManifest, saveSyncState, saveTaxonomy, scanForBinaries, serializeActivityDigest, serializeDayTranscript, shareSpace, stableHash, stripFillerTokens, structuralProviderActive, switchSpace, syncChanges, syncStateFilePath, toStructuralContextDegradation, unescapeSegmentText, unescapeSpeakerLabel, updateSourceSyncState, validateGoogleDriveConfig, validateNotionConfig, validateSlug, validateTaxonomy, watchForChanges, writeManifest };

package/dist/index.js

@@ -1,4 +1,7 @@
 import {
+  ACTIVITY_DIGEST_FORMAT_VERSION,
+  ACTIVITY_DIR_NAME,
+  ActivityStore,
   ClaudeCodeMemoryExtensionPublisher,
   CodexMemoryExtensionPublisher,
   DEFAULT_GRACE_PERIOD_DAYS,
@@ -18,11 +21,17 @@ import {
   REMNIC_RECALL_DECISION_RULES,
   REMNIC_SEMANTIC_OVERVIEW,
   WearablesService,
+  activityDatabasePath,
+  activityDayWindow,
+  activityDigestPath,
+  applyActivitySchema,
   buildProcedureRecallSection,
   clearStructuralContextProvidersForTest,
   clearWearableConnectors,
   collectLocalSessionSummaries,
   compileRedactionRules,
+  composeActivityDigestBody,
+  composeActivityDigestMeta,
   createBackend,
   createRelayMissionFixture,
   createSpace,
@@ -33,6 +42,7 @@ import {
   deleteSpace,
   describeStructuralProviderStatus,
   emptyManifest,
+  ensureActivityStateDir,
   ensureBuiltInWearableConnectors,
   findContradictions,
   findDuplicates,
@@ -48,8 +58,10 @@ import {
   getTaxonomyDir,
   getTaxonomyFilePath,
   getWearableConnector,
+  hashActivityBody,
   hostIdForConnector,
   isReviewPrompt,
+  isValidActivityDate,
   listLocalSessionSourceAdapters,
   listReviewItems,
   listSpaces,
@@ -62,8 +74,10 @@ import {
   matchesPatterns,
   mergeSpaces,
   onboard,
+  openActivityDatabase,
   packReviewContext,
   packReviewContextStructural,
+  parseActivityDigest,
   parseTouchedFiles,
   performReview,
   probeStructuralProviderForDoctor,
@@ -87,6 +101,7 @@ import {
   saveManifest,
   saveTaxonomy,
   scanForBinaries,
+  serializeActivityDigest,
   shareSpace,
   structuralProviderActive,
   switchSpace,
@@ -96,7 +111,7 @@ import {
   validateTaxonomy,
   watchForChanges,
   writeManifest
-} from "./chunk-7PY55HMI.js";
+} from "./chunk-3VBXP5HS.js";
 import {
   WEARABLE_SOURCE_PREFIX,
   buildExtractionTurns,
@@ -1038,7 +1053,10 @@ export {
   ACTION_CONFIDENCE_RISK_CATEGORIES,
   ACTION_CONFIDENCE_RULE_KINDS,
   ACTIVE_STATUSES,
+  ACTIVITY_DIGEST_FORMAT_VERSION,
+  ACTIVITY_DIR_NAME,
   AccessAuditAdapter,
+  ActivityStore,
   BRIEFING_FORMAT_ALLOWED,
   BootstrapEngine,
   CITATION_UNKNOWN,
@@ -1162,9 +1180,13 @@ export {
   WearablesInputError,
   WearablesService,
   WebSearchProvider,
+  activityDatabasePath,
+  activityDayWindow,
+  activityDigestPath,
   appendAuditEntry,
   appendInteractionLog,
   appendRelayMissionEvent,
+  applyActivitySchema,
   applyCorrections,
   applyLcmSchema,
   applyMemoryWorthFilter,
@@ -1238,6 +1260,8 @@ export {
   compileOfflineSyncExcludeGlobs,
   compileRedactionPatterns,
   compileRedactionRules,
+  composeActivityDigestBody,
+  composeActivityDigestMeta,
   composeDayTranscriptBody,
   composeDayTranscriptMeta,
   composeFusionDayMeta,
@@ -1288,6 +1312,7 @@ export {
   emptyManifest,
   emptySpeakerRegistry,
   emptySyncState,
+  ensureActivityStateDir,
   ensureBuiltInWearableConnectors,
   ensureLcmStateDir,
   ensureSentinel,
@@ -1339,6 +1364,7 @@ export {
   hasBroadGraphIntent,
   hasCitation,
   hasEnabledLiveConnector,
+  hashActivityBody,
   hashFusionBody,
   hashTranscriptBody,
   hostIdForConnector,
@@ -1370,6 +1396,7 @@ export {
   isUserBoundaryScope,
   isUserContextScope,
   isUserModelDimension,
+  isValidActivityDate,
   isValidCachedVerdict,
   isValidConnectorId,
   isValidNamespaceValue,
@@ -1429,9 +1456,11 @@ export {
   observeRequestSchema,
   offlineSyncStateFromSnapshot,
   onboard,
+  openActivityDatabase,
   openLcmDatabase,
   packReviewContext,
   packReviewContextStructural,
+  parseActivityDigest,
   parseAllCitations,
   parseAnthropicMessageParts,
   parseBriefingFocus,
@@ -1560,6 +1589,7 @@ export {
   saveTokenStore,
   scanForBinaries,
   sealedWriteToLegacyArgs,
+  serializeActivityDigest,
   serializeDayTranscript,
   serializeEntityFile,
   serializeFusionDay,

package/dist/orchestrator.js

@@ -41,7 +41,7 @@ import {
   throwIfRecallAborted,
   tokenizeRecallQuery,
   utcDateKeysForLocalDay
-} from "./chunk-7PY55HMI.js";
+} from "./chunk-3VBXP5HS.js";
 import "./chunk-5SB7SC2G.js";
 import "./chunk-3332THSR.js";
 import "./chunk-I74SUMNI.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.10.0",
+  "version": "9.12.0",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3045,7 +3045,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.10.0"
+    "@remnic/coding-graph": "^9.12.0"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/activity/digest.test.ts

@@ -0,0 +1,180 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+
+import {
+  activityDayWindow,
+  activityDigestPath,
+  composeActivityDigestBody,
+  composeActivityDigestMeta,
+  isValidActivityDate,
+  parseActivityDigest,
+  serializeActivityDigest,
+} from "./digest.js";
+import type { ActivitySnapshot } from "./types.js";
+
+function snap(overrides: Partial<ActivitySnapshot> = {}): ActivitySnapshot {
+  return {
+    machine: "macstudio",
+    capturedAtUtc: "2026-03-10T14:00:00.000Z",
+    app: "Chrome",
+    windowTitle: "Roadmap",
+    text: "quarterly roadmap review notes",
+    textSource: "ax",
+    contentHash: "h",
+    ...overrides,
+  };
+}
+
+const DAY = [
+  snap({ id: 1, contentHash: "a", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Chrome", windowTitle: "Roadmap", text: "roadmap planning" }),
+  snap({ id: 2, contentHash: "b", capturedAtUtc: "2026-03-10T14:10:00.000Z", app: "Slack", windowTitle: "#eng", text: "deploy staging soon" }),
+  snap({ id: 3, contentHash: "c", capturedAtUtc: "2026-03-10T14:12:00.000Z", app: "Chrome", windowTitle: "PR 412", browserUrl: "https://github.com/x/pull/412", text: "review pull request" }),
+];
+
+test("composeActivityDigestBody is byte-identical across two renders (deterministic)", () => {
+  const a = composeActivityDigestBody("2026-03-10", "America/Chicago", DAY);
+  const b = composeActivityDigestBody("2026-03-10", "America/Chicago", [...DAY].reverse());
+  assert.equal(a, b);
+});
+
+test("per-app time section is sorted with a stable tiebreaker on equal dwell", () => {
+  // Two apps with identical (zero) dwell — last snapshots — must order by name.
+  const snaps = [
+    snap({ id: 1, contentHash: "a", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Zed" }),
+    snap({ id: 2, contentHash: "b", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Arc" }),
+  ];
+  const body1 = composeActivityDigestBody("2026-03-10", "UTC", snaps);
+  const body2 = composeActivityDigestBody("2026-03-10", "UTC", [...snaps].reverse());
+  assert.equal(body1, body2);
+  // Arc sorts before Zed at equal dwell.
+  assert.ok(body1.indexOf("- Arc:") < body1.indexOf("- Zed:"));
+});
+
+test("contentHash is stable across renders and meta reflects inputs", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["laptop", "macstudio", "laptop"], DAY, body);
+  assert.equal(meta.kind, "activity-digest");
+  assert.equal(meta.snapshotCount, 3);
+  assert.deepEqual(meta.machines, ["laptop", "macstudio"]); // deduped + sorted
+  assert.equal(meta.contentHash, composeActivityDigestMeta("2026-03-10", ["macstudio"], DAY, body).contentHash);
+});
+
+test("serialize → parse round-trips meta and body", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["macstudio"], DAY, body);
+  const parsed = parseActivityDigest(serializeActivityDigest(meta, body));
+  assert.ok(parsed);
+  assert.deepEqual(parsed?.meta, meta);
+  assert.equal(parsed?.body, body);
+});
+
+test("parseActivityDigest returns null on malformed input", () => {
+  assert.equal(parseActivityDigest("no frontmatter here"), null);
+  assert.equal(parseActivityDigest("---\nkind: activity-digest\n(no closing fence)"), null);
+  assert.equal(parseActivityDigest("---\nkind: other\ndate: 2026-03-10\ncontentHash: x\n---\nbody"), null);
+});
+
+test("activityDayWindow yields half-open DST-aware bounds", () => {
+  const w = activityDayWindow("2026-03-10", "America/Chicago");
+  assert.equal(w.startUtc, "2026-03-10T05:00:00.000Z");
+  assert.equal(w.endUtc, "2026-03-11T05:00:00.000Z");
+  // Spring-forward day: CST→CDT shift reflected.
+  const dst = activityDayWindow("2026-03-08", "America/Chicago");
+  assert.equal(dst.startUtc, "2026-03-08T06:00:00.000Z");
+  assert.equal(dst.endUtc, "2026-03-09T05:00:00.000Z");
+});
+
+test("a snapshot at exactly local midnight lands in exactly one day", () => {
+  // Local midnight 2026-03-10 in America/Chicago (CST) == 06:00Z.
+  const midnightUtc = "2026-03-10T06:00:00.000Z";
+  const day10 = activityDayWindow("2026-03-10", "America/Chicago");
+  const day09 = activityDayWindow("2026-03-09", "America/Chicago");
+  // Included in the 10th (start-inclusive), excluded from the 9th (end-exclusive).
+  assert.ok(midnightUtc >= day10.startUtc && midnightUtc < day10.endUtc);
+  assert.ok(!(midnightUtc >= day09.startUtc && midnightUtc < day09.endUtc));
+});
+
+test("activityDigestPath places the file under <memoryDir>/activity/", () => {
+  assert.equal(activityDigestPath("/mem", "2026-03-10"), "/mem/activity/2026-03-10.md");
+});
+
+test("isValidActivityDate rejects impossible and malformed calendar days", () => {
+  assert.equal(isValidActivityDate("2026-03-10"), true);
+  assert.equal(isValidActivityDate("2026-02-30"), false); // Feb has no 30th
+  assert.equal(isValidActivityDate("2026-13-01"), false); // no month 13
+  assert.equal(isValidActivityDate("2026-00-10"), false);
+  assert.equal(isValidActivityDate("not-a-date"), false);
+  assert.equal(isValidActivityDate("2026-3-10"), false); // wrong shape
+});
+
+test("activityDigestPath rejects path-traversal / invalid dates", () => {
+  assert.equal(activityDigestPath("/mem", "2026-03-10"), "/mem/activity/2026-03-10.md");
+  assert.throws(() => activityDigestPath("/mem", "../../etc/passwd"), RangeError);
+  assert.throws(() => activityDigestPath("/mem", "2026-02-30"), RangeError);
+});
+
+test("activityDayWindow rejects an impossible date", () => {
+  assert.throws(() => activityDayWindow("2026-02-30", "UTC"), RangeError);
+  assert.throws(() => activityDayWindow("../evil", "UTC"), RangeError);
+});
+
+test("parseActivityDigest rejects a non-numeric snapshotCount/formatVersion", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["macstudio"], DAY, body);
+  const good = serializeActivityDigest(meta, body);
+  const broken = good.replace(/snapshotCount: \d+/, "snapshotCount: lots");
+  assert.equal(parseActivityDigest(broken), null);
+});
+
+test("dwell is scoped per capture machine — an interleaved machine can't steal it", () => {
+  const snaps = [
+    snap({ machine: "A", app: "A-app", capturedAtUtc: "2026-03-10T14:00:00.000Z", contentHash: "a1" }),
+    snap({ machine: "B", app: "B-app", capturedAtUtc: "2026-03-10T14:01:00.000Z", contentHash: "b1" }),
+    snap({ machine: "A", app: "A-app", capturedAtUtc: "2026-03-10T14:10:00.000Z", contentHash: "a2" }),
+  ];
+  const body = composeActivityDigestBody("2026-03-10", "UTC", snaps);
+  // A-app dwell = A@14:00 → A@14:10 = 10m (per-machine), not 1m (global next = B@14:01).
+  assert.ok(body.includes("- A-app: 10m"), body);
+});
+
+test("digest ordering is deterministic for same-time unsaved snapshots", () => {
+  const a = snap({ capturedAtUtc: "2026-03-10T14:00:00.000Z", contentHash: "h-a", app: "Alpha", text: "alpha window" });
+  const b = snap({ capturedAtUtc: "2026-03-10T14:00:00.000Z", contentHash: "h-b", app: "Beta", text: "beta window" });
+  const one = composeActivityDigestBody("2026-03-10", "UTC", [a, b]);
+  const two = composeActivityDigestBody("2026-03-10", "UTC", [b, a]);
+  assert.equal(one, two);
+});
+
+test("activityDayWindow does not backdate a skipped local midnight", () => {
+  // Egypt restarts DST on the last Friday of April at 00:00 (00:00 → 01:00),
+  // so local midnight is skipped. The day-start must land on the correct local
+  // day (the first existing local time), never backdated into the prior day.
+  const w = activityDayWindow("2026-04-24", "Africa/Cairo");
+  const local = new Intl.DateTimeFormat("en-CA", {
+    timeZone: "Africa/Cairo",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false,
+  }).format(new Date(w.startUtc));
+  assert.ok(local.startsWith("2026-04-24"), local);
+});
+
+test("timeline keeps a second machine's span even with the same app/window", () => {
+  const a = snap({ machine: "A", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Chrome", windowTitle: "Doc", contentHash: "a1", text: "" });
+  const b = snap({ machine: "B", capturedAtUtc: "2026-03-10T14:00:30.000Z", app: "Chrome", windowTitle: "Doc", contentHash: "b1", text: "" });
+  const body = composeActivityDigestBody("2026-03-10", "UTC", [a, b]);
+  // machine is part of the timeline-span key, so the same app/window on a
+  // different machine is not coalesced away.
+  const timelineLines = body.split("\n").filter((line) => line.startsWith("- ["));
+  assert.equal(timelineLines.length, 2);
+});
+
+test("machine labels with YAML-special chars round-trip through the digest", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["alpha, beta", "macstudio"], DAY, body);
+  const parsed = parseActivityDigest(serializeActivityDigest(meta, body));
+  assert.deepEqual(parsed?.meta.machines, ["alpha, beta", "macstudio"]);
+});