@aitne/daemon 0.1.0

package/dist/services/integrations/reconcile.js

@@ -0,0 +1,218 @@
+const SELECT_PRIOR_SQL = `
+  SELECT item_id   AS itemId,
+         content_hash AS contentHash,
+         payload_json AS payloadJson,
+         item_start   AS itemStart,
+         actor_hint   AS actorHint
+  FROM integration_snapshots
+  WHERE integration = ? AND window_key = ?
+`;
+const UPSERT_SQL = `
+  INSERT INTO integration_snapshots
+    (integration, window_key, item_id, content_hash, payload_json,
+     item_start, fetched_at, actor_hint)
+  VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  ON CONFLICT(integration, window_key, item_id) DO UPDATE SET
+    content_hash = excluded.content_hash,
+    payload_json = excluded.payload_json,
+    item_start   = excluded.item_start,
+    fetched_at   = excluded.fetched_at,
+    actor_hint   = excluded.actor_hint
+`;
+const DELETE_SQL = `
+  DELETE FROM integration_snapshots
+  WHERE integration = ? AND window_key = ? AND item_id = ?
+`;
+const RESOLVE_AGENT_WRITE_SQL = `
+  SELECT 1
+  FROM integration_writes
+  WHERE integration = ? AND item_id = ? AND expires_at > ?
+  LIMIT 1
+`;
+const SELECT_PARTITION_INIT_SQL = `
+  SELECT 1
+  FROM runtime_state
+  WHERE key = ?
+  LIMIT 1
+`;
+const UPSERT_PARTITION_INIT_SQL = `
+  INSERT INTO runtime_state (key, value_json, updated_at)
+  VALUES (?, 'true', CURRENT_TIMESTAMP)
+  ON CONFLICT(key) DO UPDATE SET
+    value_json = excluded.value_json,
+    updated_at = CURRENT_TIMESTAMP
+`;
+function partitionInitKey(integration, windowKey) {
+    return `integration_snapshot_initialized:${integration}:${windowKey}`;
+}
+/**
+ * Reconcile new items against the prior snapshot for
+ * `(integration, window_key)`. Single SQLite transaction; the calling
+ * route is responsible for the chokepoint audit row (§6.0) and any
+ * Phase-2 side effects.
+ *
+ * The function is exported as a regular function (not a class) so unit
+ * tests can call it directly with an in-memory `better-sqlite3` instance.
+ */
+export function reconcile(db, req, deps) {
+    const created = [];
+    const modified = [];
+    const deleted = [];
+    let unchanged = 0;
+    let prunedOutOfWindow = 0;
+    const isDryRun = req.mode === "dry-run";
+    const txn = db.transaction(() => {
+        const priorRows = db
+            .prepare(SELECT_PRIOR_SQL)
+            .all(req.integration, req.windowKey);
+        const prior = new Map();
+        for (const row of priorRows)
+            prior.set(row.itemId, row);
+        const initKey = partitionInitKey(req.integration, req.windowKey);
+        const partitionInitialized = db
+            .prepare(SELECT_PARTITION_INIT_SQL)
+            .get(initKey) !== undefined;
+        const isInitialSnapshot = (!partitionInitialized && prior.size === 0)
+            || req.isInitialSnapshot === true;
+        const seenIds = new Set();
+        const upsert = db.prepare(UPSERT_SQL);
+        const remove = db.prepare(DELETE_SQL);
+        const resolveAgent = db.prepare(RESOLVE_AGENT_WRITE_SQL);
+        const resolveActor = (itemId, fallback, resolverBeforeFallback = false) => {
+            const writeRow = resolveAgent.get(req.integration, itemId, req.fetchedAt);
+            if (writeRow !== undefined)
+                return "agent";
+            const resolved = deps.resolveActorHint?.(req.integration, itemId);
+            // The deleted-item caller always passes priorRow.actor_hint, which
+            // is a NOT-NULL DEFAULT 'user' column → `fallback` is guaranteed
+            // defined under resolverBeforeFallback=true. The trailing `?? "user"`
+            // there is therefore unreachable; the live-item caller (=false) is
+            // where the chain bottoms out at the literal default.
+            return resolverBeforeFallback
+                ? (resolved ?? /* c8 ignore next */ fallback ?? "user")
+                : (fallback ?? resolved ?? "user");
+        };
+        for (const item of req.items) {
+            seenIds.add(item.itemId);
+            const priorRow = prior.get(item.itemId);
+            const itemStart = item.itemStart ?? null;
+            // Resolve actor: integration_writes wins, else caller hint, else
+            // 'user'. Reconcile reads the table inside the same transaction so
+            // a write-then-reconcile race within the same SQLite connection
+            // sees the just-inserted row.
+            const actor = resolveActor(item.itemId, item.actorHint);
+            if (priorRow === undefined) {
+                // New item.
+                if (!isDryRun) {
+                    upsert.run(req.integration, req.windowKey, item.itemId, item.contentHash, JSON.stringify(item.payload), itemStart, req.fetchedAt, actor);
+                }
+                if (!isInitialSnapshot) {
+                    created.push({
+                        itemId: item.itemId,
+                        contentHash: item.contentHash,
+                        payload: item.payload,
+                        itemStart,
+                        actorHint: item.actorHint,
+                        actor,
+                    });
+                }
+                continue;
+            }
+            if (priorRow.contentHash === item.contentHash) {
+                // No-op for the diff, but bump fetched_at so the partition's
+                // freshness signal stays current.
+                if (!isDryRun) {
+                    upsert.run(req.integration, req.windowKey, item.itemId, item.contentHash, JSON.stringify(item.payload), itemStart, req.fetchedAt, actor);
+                }
+                unchanged += 1;
+                continue;
+            }
+            // Modified — hash differs.
+            const priorPayload = JSON.parse(priorRow.payloadJson);
+            if (!isDryRun) {
+                upsert.run(req.integration, req.windowKey, item.itemId, item.contentHash, JSON.stringify(item.payload), itemStart, req.fetchedAt, actor);
+            }
+            if (!isInitialSnapshot) {
+                modified.push({
+                    itemId: item.itemId,
+                    prior: {
+                        contentHash: priorRow.contentHash,
+                        payload: priorPayload,
+                    },
+                    current: {
+                        contentHash: item.contentHash,
+                        payload: item.payload,
+                    },
+                    itemStart,
+                    actor,
+                });
+            }
+        }
+        // Prior items missing from new fetch: distinguish "slid out of window"
+        // from "truly deleted upstream" via the per-integration predicate
+        // (§5.1). Both cases delete the snapshot row; only the second emits a
+        // diff entry that Phase-2 effects will translate to an observation.
+        for (const priorRow of priorRows) {
+            if (seenIds.has(priorRow.itemId))
+                continue;
+            const priorPayload = JSON.parse(priorRow.payloadJson);
+            const stillInWindow = deps.normalizer.inWindow(priorPayload, req.windowMin, req.windowMax);
+            if (!isDryRun) {
+                remove.run(req.integration, req.windowKey, priorRow.itemId);
+            }
+            if (!stillInWindow) {
+                prunedOutOfWindow += 1;
+                continue;
+            }
+            if (!isInitialSnapshot) {
+                const actor = resolveActor(priorRow.itemId, priorRow.actorHint, true);
+                deleted.push({
+                    itemId: priorRow.itemId,
+                    payload: priorPayload,
+                    itemStart: priorRow.itemStart,
+                    actor,
+                });
+            }
+        }
+        if (!isDryRun) {
+            deps.onDiffInTransaction?.({
+                created,
+                modified,
+                deleted,
+                unchanged,
+                prunedOutOfWindow,
+                isInitialSnapshot,
+            });
+            db.prepare(UPSERT_PARTITION_INIT_SQL).run(initKey);
+        }
+        return isInitialSnapshot;
+    });
+    const isInitialSnapshot = txn();
+    return {
+        created,
+        modified,
+        deleted,
+        unchanged,
+        prunedOutOfWindow,
+        isInitialSnapshot,
+    };
+}
+/**
+ * Insert (or refresh) an `integration_writes` row tagging a given item as
+ * agent-originated for the next `ttlMs` milliseconds. Called from route
+ * handlers after a successful write to the upstream service so the next
+ * reconcile diff resolves `actor='agent'`. Phase 1 exposes the helper
+ * but no route calls it yet — Phase 4 wires up the calendar / mail /
+ * notion write surfaces.
+ */
+export function markIntegrationWrite(db, params) {
+    const expiresAt = new Date(new Date(params.nowIso).getTime() + params.ttlMs).toISOString();
+    db.prepare(`INSERT INTO integration_writes
+       (integration, item_id, written_at, written_by, expires_at)
+     VALUES (?, ?, ?, 'agent', ?)
+     ON CONFLICT(integration, item_id) DO UPDATE SET
+       written_at = excluded.written_at,
+       written_by = excluded.written_by,
+       expires_at = excluded.expires_at`).run(params.integration, params.itemId, params.nowIso, expiresAt);
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/services/integrations/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../../../src/services/integrations/reconcile.ts"],"names":[],"mappings":"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"}

package/dist/services/integrations/snapshot-partitions.d.ts

@@ -0,0 +1,40 @@
+import type Database from "better-sqlite3";
+import type { IntegrationKey, IntegrationMode } from "@aitne/shared";
+/**
+ * INTEGRATION-DRIFT-PHASE-7-PLAN.md §3.3 — per-integration ownership map
+ * over `integration_snapshots` window-key partitions, indexed by the
+ * `IntegrationMode` whose writer owns each partition.
+ *
+ *   - `direct`: writers are the in-process pollers (CalendarPoller).
+ *     `primary:14d` is calendar's direct-mode window.
+ *   - `delegated`: writers are the DelegatedSyncWorker cadences. Calendar
+ *     uses `primary:imminent` + `primary:24h`; Gmail uses `inbox:7d`;
+ *     Notion uses `recently_updated`.
+ *   - `disabled`: no writer; partitions are empty.
+ *
+ * The map is the single source of truth for the §3.3 stale-partition
+ * cleanup. Phase 6's direct-mode unification will populate the direct
+ * row for gmail / notion; until then those rows stay empty so the
+ * helper is a no-op for them.
+ */
+export declare const INTEGRATION_SNAPSHOT_PARTITIONS_BY_MODE: Readonly<Record<IntegrationKey, Readonly<Record<IntegrationMode, readonly string[]>>>>;
+/**
+ * Compute the set of window keys that were owned by `prev` but are not
+ * owned by `next`. These are the partitions whose writer is going away —
+ * leaving them in `integration_snapshots` would let a future flip-back
+ * see their stale prior set as the diff baseline and emit a one-tick
+ * burst of spurious `modified` / `deleted` entries.
+ */
+export declare function partitionsToPurge(integration: IntegrationKey, prev: IntegrationMode, next: IntegrationMode): string[];
+/**
+ * Delete `integration_snapshots` rows and the matching `runtime_state`
+ * partition-init flags for partitions whose writer just went away. Best-
+ * effort: failures log warn and never throw — `applyIntegrationModeChange`
+ * is the only caller and the integration mode flip itself has already
+ * been persisted by the time this runs, so an error here is hygiene
+ * lost, not state corrupted.
+ *
+ * Returns the partitions that were processed for log + test visibility.
+ */
+export declare function purgeStaleSnapshotPartitions(db: Database.Database, integration: IntegrationKey, prev: IntegrationMode, next: IntegrationMode): string[];
+//# sourceMappingURL=snapshot-partitions.d.ts.map

package/dist/services/integrations/snapshot-partitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-partitions.d.ts","sourceRoot":"","sources":["../../../src/services/integrations/snapshot-partitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKrE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uCAAuC,EAAE,QAAQ,CAC5D,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,CAyC7E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,eAAe,GACpB,MAAM,EAAE,CASV;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,eAAe,GACpB,MAAM,EAAE,CAgCV"}

package/dist/services/integrations/snapshot-partitions.js

@@ -0,0 +1,113 @@
+import { createLogger } from "../../logging.js";
+const logger = createLogger("snapshot-partitions");
+/**
+ * INTEGRATION-DRIFT-PHASE-7-PLAN.md §3.3 — per-integration ownership map
+ * over `integration_snapshots` window-key partitions, indexed by the
+ * `IntegrationMode` whose writer owns each partition.
+ *
+ *   - `direct`: writers are the in-process pollers (CalendarPoller).
+ *     `primary:14d` is calendar's direct-mode window.
+ *   - `delegated`: writers are the DelegatedSyncWorker cadences. Calendar
+ *     uses `primary:imminent` + `primary:24h`; Gmail uses `inbox:7d`;
+ *     Notion uses `recently_updated`.
+ *   - `disabled`: no writer; partitions are empty.
+ *
+ * The map is the single source of truth for the §3.3 stale-partition
+ * cleanup. Phase 6's direct-mode unification will populate the direct
+ * row for gmail / notion; until then those rows stay empty so the
+ * helper is a no-op for them.
+ */
+export const INTEGRATION_SNAPSHOT_PARTITIONS_BY_MODE = {
+    google_calendar: {
+        direct: ["primary:14d"],
+        delegated: ["primary:imminent", "primary:24h"],
+        disabled: [],
+    },
+    gmail: {
+        direct: [],
+        delegated: ["inbox:7d"],
+        disabled: [],
+    },
+    notion: {
+        direct: [],
+        delegated: ["recently_updated"],
+        disabled: [],
+    },
+    git: {
+        direct: [],
+        delegated: [],
+        disabled: [],
+    },
+    github: {
+        direct: [],
+        delegated: [],
+        disabled: [],
+    },
+    // SETUP-FLOW-REDESIGN-PLAN §6.1 — Outlook integrations are direct-only
+    // in v1 with no MCP connectors, so the delegated drift snapshot path
+    // never owns any partitions. Empty rows keep the type system honest
+    // without committing to a partitioning scheme yet.
+    outlook_mail: {
+        direct: [],
+        delegated: [],
+        disabled: [],
+    },
+    outlook_calendar: {
+        direct: [],
+        delegated: [],
+        disabled: [],
+    },
+};
+/**
+ * Compute the set of window keys that were owned by `prev` but are not
+ * owned by `next`. These are the partitions whose writer is going away —
+ * leaving them in `integration_snapshots` would let a future flip-back
+ * see their stale prior set as the diff baseline and emit a one-tick
+ * burst of spurious `modified` / `deleted` entries.
+ */
+export function partitionsToPurge(integration, prev, next) {
+    const ownership = INTEGRATION_SNAPSHOT_PARTITIONS_BY_MODE[integration];
+    const prevSet = new Set(ownership[prev]);
+    const nextSet = new Set(ownership[next]);
+    const out = [];
+    for (const key of prevSet) {
+        if (!nextSet.has(key))
+            out.push(key);
+    }
+    return out.sort();
+}
+/**
+ * Delete `integration_snapshots` rows and the matching `runtime_state`
+ * partition-init flags for partitions whose writer just went away. Best-
+ * effort: failures log warn and never throw — `applyIntegrationModeChange`
+ * is the only caller and the integration mode flip itself has already
+ * been persisted by the time this runs, so an error here is hygiene
+ * lost, not state corrupted.
+ *
+ * Returns the partitions that were processed for log + test visibility.
+ */
+export function purgeStaleSnapshotPartitions(db, integration, prev, next) {
+    const stale = partitionsToPurge(integration, prev, next);
+    if (stale.length === 0)
+        return [];
+    try {
+        const txn = db.transaction((keys) => {
+            const deleteSnapshot = db.prepare("DELETE FROM integration_snapshots WHERE integration = ? AND window_key = ?");
+            const deleteInit = db.prepare("DELETE FROM runtime_state WHERE key = ?");
+            for (const windowKey of keys) {
+                deleteSnapshot.run(integration, windowKey);
+                deleteInit.run(`integration_snapshot_initialized:${integration}:${windowKey}`);
+            }
+        });
+        txn(stale);
+        logger.info({ integration, prev, next, purgedPartitions: stale }, "Purged stale integration_snapshots partitions after mode change");
+    }
+    catch (err) {
+        /* c8 ignore start — defensive against a malformed schema in a stripped
+         *   test harness; live daemon path always has the tables. */
+        logger.warn({ err, integration, prev, next, purgedPartitions: stale }, "Failed to purge stale snapshot partitions; mode change still applied");
+        /* c8 ignore stop */
+    }
+    return stale;
+}
+//# sourceMappingURL=snapshot-partitions.js.map

package/dist/services/integrations/snapshot-partitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-partitions.js","sourceRoot":"","sources":["../../../src/services/integrations/snapshot-partitions.ts"],"names":[],"mappings":"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"}

package/dist/services/journal/render.d.ts

@@ -0,0 +1,15 @@
+export type JournalMirrorRendering = "plain" | "obsidian";
+export interface RenderJournalMirrorOptions {
+    rendering: JournalMirrorRendering;
+}
+/**
+ * B-007 Phase 3 / B-005 split:
+ * the morning routine synthesizes `context/daily/*.md`; journal services only
+ * mirror that already-rendered content to another root.
+ *
+ * Rendering is therefore intentionally pass-through for now. Future B-005
+ * work can extend this module with backend-specific transforms without
+ * reintroducing synthesis responsibility here.
+ */
+export declare function renderJournalMirrorContent(content: string, opts: RenderJournalMirrorOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/services/journal/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/services/journal/render.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,sBAAsB,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,0BAA0B,GAC/B,MAAM,CAMR"}

package/dist/services/journal/render.js

@@ -0,0 +1,17 @@
+/**
+ * B-007 Phase 3 / B-005 split:
+ * the morning routine synthesizes `context/daily/*.md`; journal services only
+ * mirror that already-rendered content to another root.
+ *
+ * Rendering is therefore intentionally pass-through for now. Future B-005
+ * work can extend this module with backend-specific transforms without
+ * reintroducing synthesis responsibility here.
+ */
+export function renderJournalMirrorContent(content, opts) {
+    switch (opts.rendering) {
+        case "plain":
+        case "obsidian":
+            return content;
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/services/journal/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/services/journal/render.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,IAAgC;IAEhC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,OAAO,CAAC;QACb,KAAK,UAAU;YACb,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/services/journal/writer.d.ts

@@ -0,0 +1,26 @@
+import { type JournalMirrorRendering } from "./render.js";
+export type JournalMirrorTargetKind = "filesystem" | "obsidian" | "project-root";
+export interface JournalMirrorTarget {
+    kind: JournalMirrorTargetKind;
+    rootPath: string;
+    subdirectory?: string | null;
+}
+export interface JournalMirrorWriteInput {
+    relativePath: string;
+    content: string;
+    rendering: JournalMirrorRendering;
+}
+export interface JournalMirrorWriteResult {
+    targetPath: string;
+    bytesWritten: number;
+}
+/**
+ * Mirror-only journal writer. The source markdown is already synthesized by
+ * the morning routine into `context/daily/*.md`; this service only writes the
+ * mirrored copy to another root for B-005 backends.
+ */
+export declare class JournalMirrorService {
+    write(target: JournalMirrorTarget, input: JournalMirrorWriteInput): JournalMirrorWriteResult;
+}
+export declare function resolveJournalMirrorPath(target: JournalMirrorTarget, relativePath: string): string;
+//# sourceMappingURL=writer.d.ts.map

package/dist/services/journal/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/services/journal/writer.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,UAAU,GAAG,cAAc,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,sBAAsB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,KAAK,CACH,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,uBAAuB,GAC7B,wBAAwB;CAY5B;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,GACnB,MAAM,CAMR"}

package/dist/services/journal/writer.js

@@ -0,0 +1,50 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, join, normalize } from "node:path";
+import { renderJournalMirrorContent, } from "./render.js";
+/**
+ * Mirror-only journal writer. The source markdown is already synthesized by
+ * the morning routine into `context/daily/*.md`; this service only writes the
+ * mirrored copy to another root for B-005 backends.
+ */
+export class JournalMirrorService {
+    write(target, input) {
+        const targetPath = resolveJournalMirrorPath(target, input.relativePath);
+        const rendered = renderJournalMirrorContent(input.content, {
+            rendering: input.rendering,
+        });
+        mkdirSync(dirname(targetPath), { recursive: true });
+        writeFileSync(targetPath, rendered, "utf-8");
+        return {
+            targetPath,
+            bytesWritten: Buffer.byteLength(rendered, "utf-8"),
+        };
+    }
+}
+export function resolveJournalMirrorPath(target, relativePath) {
+    const normalizedRelativePath = normalizeRelativeJournalPath(relativePath);
+    const normalizedSubdirectory = normalizeOptionalRelativePath(target.subdirectory);
+    return normalizedSubdirectory
+        ? join(target.rootPath, normalizedSubdirectory, normalizedRelativePath)
+        : join(target.rootPath, normalizedRelativePath);
+}
+function normalizeOptionalRelativePath(value) {
+    if (!value)
+        return "";
+    return normalizeRelativeJournalPath(value);
+}
+function normalizeRelativeJournalPath(value) {
+    if (!value.trim()) {
+        throw new Error("Journal mirror path must not be empty.");
+    }
+    if (isAbsolute(value)) {
+        throw new Error("Journal mirror path must be relative.");
+    }
+    const normalized = normalize(value).replace(/\\/g, "/").replace(/^\.\/+/, "");
+    if (normalized === "." ||
+        normalized === ".." ||
+        normalized.startsWith("../")) {
+        throw new Error("Journal mirror path must stay inside the target root.");
+    }
+    return normalized;
+}
+//# sourceMappingURL=writer.js.map

package/dist/services/journal/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../src/services/journal/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EACL,0BAA0B,GAE3B,MAAM,aAAa,CAAC;AAqBrB;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAC/B,KAAK,CACH,MAA2B,EAC3B,KAA8B;QAE9B,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE;YACzD,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO;YACL,UAAU;YACV,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC;SACnD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CACtC,MAA2B,EAC3B,YAAoB;IAEpB,MAAM,sBAAsB,GAAG,4BAA4B,CAAC,YAAY,CAAC,CAAC;IAC1E,MAAM,sBAAsB,GAAG,6BAA6B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClF,OAAO,sBAAsB;QAC3B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,sBAAsB,CAAC;QACvE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,6BAA6B,CAAC,KAAgC;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAa;IACjD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC9E,IACE,UAAU,KAAK,GAAG;QAClB,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}