@aligndottech/cli 0.48.0 → 0.50.0

package/dist/lib/sync/relink.js

@@ -0,0 +1,36 @@
+/**
+ * L5, Decision 30: the re-link queue. Every row's `enriched_at` is NULL after the v7 upgrade (and
+ * after an ingest that died mid-way), because nothing on disk tells a finished ingest from an
+ * unfinished one. Each sync takes those rows, oldest first, and runs only the step each one is
+ * missing: the link pass alone when the embedding is stored (no embed call), a full re-ingest when
+ * it is not. After the first sync the queue is empty and this does no work.
+ *
+ * Local and free: no network, no LLM. It runs in the background child like the rest of the sync.
+ */
+import { EMBEDDING_MODEL_ID } from '../local-embeddings.js';
+import { unfinishedRows } from './sync-state.js';
+const BATCH = 1_000;
+export async function relinkAll(dbPath, client, o = {}) {
+    const now = o.now ?? Date.now;
+    const total = { linked: 0, embedded: 0, skipped: 0, timedOut: false };
+    const seen = new Set();
+    for (;;) {
+        if (o.deadlineAt !== undefined && now() >= o.deadlineAt) {
+            total.timedOut = true;
+            break;
+        }
+        // Ask for enough to step over what was already handed over, or a long run of handled-but-unstamped rows
+        // at the head of the queue would end it early with rows still waiting behind them.
+        const rows = unfinishedRows(dbPath, EMBEDDING_MODEL_ID, (o.batch ?? BATCH) + seen.size).filter((r) => !seen.has(r.id)).slice(0, o.batch ?? BATCH);
+        if (rows.length === 0)
+            break;
+        for (const r of rows)
+            seen.add(r.id);
+        const r = await client.relinkUnfinished(rows);
+        total.linked += r.linked;
+        total.embedded += r.embedded;
+        total.skipped += r.skipped;
+    }
+    return total;
+}
+//# sourceMappingURL=relink.js.map

package/dist/lib/sync/relink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relink.js","sourceRoot":"","sources":["../../../src/lib/sync/relink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,KAAK,GAAG,KAAK,CAAC;AAEpB,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAc,EACd,MAA6E,EAC7E,IAAiE,EAAE;IAEnE,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAC9B,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,SAAS,CAAC;QACR,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YAAC,MAAM;QAAC,CAAC;QAC1F,wGAAwG;QACxG,mFAAmF;QACnF,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;QAClJ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM;QAC7B,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC9C,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC;QACzB,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC;QAC7B,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/sync/report.d.ts

@@ -0,0 +1,3 @@
+import type { SourceOutcome } from './run-source.js';
+export declare function renderOutcome(o: SourceOutcome): string[];
+//# sourceMappingURL=report.d.ts.map

package/dist/lib/sync/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/report.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAUrD,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAgCxD"}

package/dist/lib/sync/report.js

@@ -0,0 +1,54 @@
+/**
+ * L5: what a sync says, in words a person can act on. One renderer for the CLI line and for the
+ * `align_sync` status text, so the two cannot describe the same run differently.
+ *
+ * Honesty rules (the plan's, verification.md's): an incomplete read says the date it reached and
+ * the skip that stopped it; a drain that ran out of budget says how many items are still thin; a
+ * refused token says the command to run and nothing about deleting anything; no line carries item
+ * content or a raw URL (the SDK's skip details are written to be printed).
+ */
+import { CAPTURE_SOURCES } from '../capture-sources.js';
+const labelOf = (id) => CAPTURE_SOURCES[id]?.label ?? id;
+const day = (iso) => iso.slice(0, 10);
+/** The skip that stopped a read short: the first incomplete kind, in the fetcher's own words. */
+function stopper(skips) {
+    return skips.find((s) => s.kind !== undefined && s.kind !== 'shape');
+}
+export function renderOutcome(o) {
+    const label = labelOf(o.source);
+    switch (o.state) {
+        case 'not_connected':
+        case 'needs_reauth':
+        case 'manual':
+        case 'locked':
+        case 'backfill_running':
+        case 'recent':
+            return [`${label}: ${o.message ?? o.state}`];
+        case 'error':
+            return [`${label}: the sync failed (${o.message ?? 'unknown error'}). Nothing about the saved token changed; the next sync tries again.`];
+        case 'ok':
+        case 'partial': {
+            const since = o.since !== undefined ? ` since ${day(o.since)}` : '';
+            const lines = [`${label}: ${o.read} read${since} (${o.created} new, ${o.updated} changed).`];
+            if (o.state === 'partial') {
+                const why = stopper(o.skips);
+                const reached = o.reachedBack !== undefined ? ` Reached back to ${day(o.reachedBack)}; the next sync carries on from there.` : '';
+                lines.push(`  Stopped early${why ? `: ${why.count} ${why.detail}` : ''}.${reached}`);
+            }
+            if (o.scopeNote)
+                lines.push(`  Read ${o.scopeNote}.`);
+            if (o.scopeLine)
+                lines.push(`  ${o.scopeLine}`);
+            if (o.persistentHole)
+                lines.push(`  Persistent hole: ${o.persistentHole}. The sync reads the rest and no longer waits for it; fix the access or leave it.`);
+            if (o.drain && (o.drain.enriched > 0 || o.drain.remaining > 0)) {
+                lines.push(`  Discussion: ${o.drain.enriched} read${o.drain.remaining > 0 ? `, ${o.drain.remaining} still to come (the next sync continues)` : ''}.`);
+            }
+            const rest = o.skips.filter((s) => s !== stopper(o.skips) && !(o.drain?.skips ?? []).includes(s));
+            for (const s of rest)
+                lines.push(`  ${s.count} ${s.detail}.`);
+            return lines;
+        }
+    }
+}
+//# sourceMappingURL=report.js.map

package/dist/lib/sync/report.js.map

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

package/dist/lib/sync/run-all.d.ts

@@ -0,0 +1,23 @@
+/**
+ * L5: one `align sync` invocation across sources: each source under its own lock, then the
+ * re-link queue once (it belongs to the graph, not to a source), then the launch summary.
+ */
+/** The re-link queue gets its OWN budget, counted from when it starts: a source that spent all of its own must not leave the queue none. */
+export declare const RELINK_BUDGET_MS = 60000;
+import { type RelinkResult } from './relink.js';
+import { type SourceOutcome, type SyncEnv } from './run-source.js';
+export interface SyncRunResult {
+    outcomes: SourceOutcome[];
+    /** Absent when another process holds the re-link lock (it is doing that work). */
+    relink?: RelinkResult & {
+        timedOut: boolean;
+    };
+    /** The re-link queue failed. The sources were already synced and recorded; this is reported, not thrown. */
+    relinkError?: string;
+}
+export declare function runSync(sources: readonly string[], env: SyncEnv, o?: {
+    trigger: 'cli' | 'background';
+    minIntervalMs?: number;
+    onOutcome?: (o: SourceOutcome) => void;
+}): Promise<SyncRunResult>;
+//# sourceMappingURL=run-all.d.ts.map

package/dist/lib/sync/run-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-all.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/run-all.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,4IAA4I;AAC5I,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,OAAO,EAAc,MAAM,iBAAiB,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,kFAAkF;IAClF,MAAM,CAAC,EAAE,YAAY,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,4GAA4G;IAC5G,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,OAAO,EACZ,CAAC,GAAE;IAAE,OAAO,EAAE,KAAK,GAAG,YAAY,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;CAAuB,GACxH,OAAO,CAAC,aAAa,CAAC,CAiBxB"}

package/dist/lib/sync/run-all.js

@@ -0,0 +1,30 @@
+/**
+ * L5: one `align sync` invocation across sources: each source under its own lock, then the
+ * re-link queue once (it belongs to the graph, not to a source), then the launch summary.
+ */
+/** The re-link queue gets its OWN budget, counted from when it starts: a source that spent all of its own must not leave the queue none. */
+export const RELINK_BUDGET_MS = 60_000;
+import { relinkAll } from './relink.js';
+import { syncSource } from './run-source.js';
+export async function runSync(sources, env, o = { trigger: 'cli' }) {
+    const outcomes = [];
+    for (const source of sources) {
+        const out = await syncSource(source, env, { trigger: o.trigger, ...(o.minIntervalMs !== undefined ? { minIntervalMs: o.minIntervalMs } : {}) });
+        outcomes.push(out);
+        o.onOutcome?.(out);
+    }
+    const lock = env.lock('sync-relink');
+    if (!lock.ok)
+        return { outcomes };
+    try {
+        const relink = await relinkAll(env.dbPath, env.client, { deadlineAt: env.now().getTime() + RELINK_BUDGET_MS, now: () => env.now().getTime() });
+        return { outcomes, relink };
+    }
+    catch (e) {
+        return { outcomes, relinkError: (e instanceof Error ? e.message : String(e)).slice(0, 200) };
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=run-all.js.map

package/dist/lib/sync/run-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-all.js","sourceRoot":"","sources":["../../../src/lib/sync/run-all.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,4IAA4I;AAC5I,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,OAAO,EAAE,SAAS,EAAqB,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAoC,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU/E,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAA0B,EAC1B,GAAY,EACZ,IAAuG,EAAE,OAAO,EAAE,KAAK,EAAE;IAEzH,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChJ,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,gBAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/I,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC/F,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/lib/sync/run-source.d.ts

@@ -0,0 +1,73 @@
+/**
+ * L5: one source, one sync run. The orchestration the pure pieces (window.ts, threads.ts) and
+ * the stores (sync-state.ts, drain.ts) are built for. Everything that touches the world arrives
+ * through `SyncEnv`, so a test runs the whole flow against a real graph file with a scripted fetch.
+ *
+ * What a run guarantees:
+ * - One writer per source: the lock is taken first and released in `finally`.
+ * - The watermark is never ahead of committed data. Items are ingested OLDEST FIRST in batches and,
+ *   on a complete read, high_water follows each committed batch; an incomplete read moves nothing
+ *   until it is finished (window.ts: finishRun).
+ * - A refused token is recorded (`needs_reauth`), never deleted, and never prompted for.
+ * - No classification, ever: ingest runs with `classify: false` (Decision 1).
+ * - A partial item (a Slack hot-thread re-read) is merged into the stored thread (Review addendum 3).
+ */
+import type { CaptureFetchResult, CaptureSkip } from '../fetchers/capture.js';
+import type { createLocalGatewayClient } from '../local-gateway-client.js';
+import { type DrainResult } from './drain.js';
+import type { Lock } from './lock.js';
+import type { SourceWindow, SyncScope } from './sources.js';
+import { type SyncStatus } from './sync-state.js';
+export type SourceState = SyncStatus | 'locked' | 'backfill_running' | 'recent' | 'not_connected' | 'manual';
+export interface SourceOutcome {
+    source: string;
+    state: SourceState;
+    /** Items the vendor returned this run. */
+    read: number;
+    created: number;
+    updated: number;
+    /** The oldest date this run reached, when it had to say so (an incomplete read). */
+    reachedBack?: string;
+    /** The lower bound the run asked the vendor for (absent for "all"). */
+    since?: string;
+    skips: CaptureSkip[];
+    drain?: DrainResult;
+    scopeNote?: string;
+    /** L4: why this source is only yours, or how to widen it - one line, printed as it is. */
+    scopeLine?: string;
+    message?: string;
+    /** Set when this run's hole has now come back PERSISTENT_HOLE_RUNS times in a row. */
+    persistentHole?: string;
+    /** Whose items this run read, once the scope was decided. Absent for a source that never got that far (locked, not connected). Only the telemetry reads it. */
+    scope?: 'yours' | 'team';
+}
+export interface SyncEnv {
+    dbPath: string;
+    now(): Date;
+    tokens(source: string): Record<string, string> | null;
+    scopeOf(source: string, o: {
+        trigger: 'cli' | 'background';
+    }): Promise<SyncScope>;
+    /** L4: print the one-time team-scope disclosure. Wired only for a foreground run; nobody is there to read it in the background. */
+    announce?(source: string, line: string): void;
+    /** L4: ask a person, default No, before an agent's waiting scope is read. Absent: not asked, so not read. */
+    confirm?(source: string, message: string): Promise<boolean>;
+    /** L4: remember the disclosure was told. Called only after `announce`. */
+    markDisclosed?(source: string, scopeKey: string): void;
+    fetch(source: string, tokens: Record<string, string>, win: SourceWindow, scope: SyncScope): Promise<CaptureFetchResult>;
+    client: Pick<ReturnType<typeof createLocalGatewayClient>, 'ingestBatch' | 'relinkUnfinished'>;
+    lock(name: string): Lock;
+    backfillRunning(source: string): boolean;
+    batchSize?: number;
+    /** Re-read ONE item whole by its URL (a Slack thread), or undefined when that is not possible. */
+    fetchWhole?: (source: string, tokens: Record<string, string>, url: string) => Promise<CaptureFetchResult['items'][number] | undefined>;
+    /** The GitHub discussion drain; defaults to the real one over `client`. A seam for tests. */
+    drain?: (token: string, deadlineMs: number) => Promise<DrainResult>;
+}
+export declare function syncSource(source: string, env: SyncEnv, 
+/** `minIntervalMs` applies to a background run only: a launch's child that finds the source tried more recently than this stops, so the interval holds across launches. */
+o?: {
+    trigger: 'cli' | 'background';
+    minIntervalMs?: number;
+}): Promise<SourceOutcome>;
+//# sourceMappingURL=run-source.d.ts.map

package/dist/lib/sync/run-source.d.ts.map

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

package/dist/lib/sync/run-source.js

@@ -0,0 +1,262 @@
+import { isAuthExpiry } from '../errors.js';
+import { SYNC_TIME_BUDGET_MS } from '../import-defaults.js';
+import { describeScopeKey } from '../scope-values.js';
+import { connectorItemKey } from '../source-key.js';
+import { drainGitHub } from './drain.js';
+import { advanceHighWater, beginRun, markNeedsReauth, readRows, recordActivity, saveRun, storedByKey, threadRows, } from './sync-state.js';
+import { HOT_THREAD_DAYS, mergePartialThread, selectHotThreads } from './threads.js';
+import { ascendingByUpdated, finishRun, inheritedWindowSince, later, newestUpdated, nextWindow, PERSISTENT_HOLE_RUNS, plausible } from './window.js';
+const BATCH = 50;
+/**
+ * Which incompleteness is a DATE-ORDERED CUT, per source. A cut is only safe to resume with `until = oldestReached` when the fetcher
+ * read ONE listing, newest first, and stopped: then everything newer than the oldest item it returned was read. Anything else leaves
+ * a gap that no date describes (a space, a team, a channel, a second query, a slice that was never reached), and resuming "below
+ * the oldest item" would skip it for good. Read from the SDK (node_modules/@aligndottech/connector-core/dist/fetchers), verified one by one:
+ *
+ * - jira:   jira.js:52 `ORDER BY updated DESC`, one JQL, one page token chain. Its stops, `time_budget` (:141) and `page_cap` (:146), both say
+ *           "older issues not read". With the item limit it emits no skip at all (:182): a cut with no skip kinds.
+ * - notion: notion.js:171-197 one search sorted last_edited_time descending. `time_budget` (:238) stops it. Its `page_cap` (:158, :235) is a
+ *           page BODY cut, not a listing stop, so it is a hole.
+ * - gitlab: gitlab.js:58-112 one merge-request listing, updated_at descending; `time_budget` (:112) stops it. An unreadable page is an
+ *           `error` skip and is a hole.
+ *
+ * Everything else is a hole, by reading, not by guessing:
+ * - github: github.js:306-329 runs SEVERAL searches (involves, reviewed-by, issues, or repo PRs and issues), each month-sliced newest first
+ *           (githubSearch.js:104-129), then `interleave`s them and trims to the limit (:327). The kept items are a prefix of EACH list, not of
+ *           the merged one, so `oldestReached` is the oldest of the shortest prefix and the longer list's items below it are unread.
+ *           Its `vendor_cap` (githubSearch.js:146) is a per-slice ceiling with older slices still read.
+ * - linear: linear.js:176 two parallel streams (assigned, created); confluence.js:206 one listing per space, `time_budget` ends the loop
+ *           with whole spaces unread; teams.js:211-222 team by team, channel by channel; zoom.js:181 30-day windows; slack walks channels.
+ */
+const CUT_KINDS_BY_SOURCE = {
+    jira: new Set(['time_budget', 'page_cap']),
+    notion: new Set(['time_budget']),
+    gitlab: new Set(['time_budget']),
+};
+/** Platforms whose partial items are threads of messages (Slack hot threads, Teams reply caps). */
+const MERGEABLE = new Set(['slack', 'teams']);
+const none = (source, state, message) => ({ source, state, read: 0, created: 0, updated: 0, skips: [], message });
+export async function syncSource(source, env, 
+/** `minIntervalMs` applies to a background run only: a launch's child that finds the source tried more recently than this stops, so the interval holds across launches. */
+o = { trigger: 'cli' }) {
+    const tokens = env.tokens(source);
+    if (tokens === null || !tokens['token'])
+        return none(source, 'not_connected', `${source} is not connected. Run: align connect ${source}`);
+    // Decision 21: a Teams token lasts about an hour, so a background run would hold a dead one.
+    if (source === 'teams' && o.trigger === 'background')
+        return none(source, 'manual', 'Teams is refreshed by hand: align connect teams');
+    const lock = env.lock(`sync-${source}`);
+    if (!lock.ok)
+        return none(source, 'locked', `already syncing${lock.holder ? ` (started ${lock.holder.started_at.slice(0, 16).replace('T', ' ')} UTC)` : ''}`);
+    try {
+        if (o.trigger === 'background' && o.minIntervalMs !== undefined) {
+            // Re-read AFTER taking the lock: the launcher's decision is older than the 20 s the child waited, and another child may have just finished.
+            const nowMs = env.now().getTime();
+            const tried = readRows(env.dbPath, source).flatMap((r) => [r.last_success_at, r.last_attempt_at])
+                .map((t) => (t === null ? Number.NaN : Date.parse(t))).filter((t) => !Number.isNaN(t) && t <= nowMs);
+            if (tried.length > 0 && nowMs - Math.max(...tried) < o.minIntervalMs)
+                return none(source, 'recent', `${source} was refreshed less than ${Math.round(o.minIntervalMs / 60_000)} minutes ago`);
+        }
+        if (env.backfillRunning(source))
+            return none(source, 'backfill_running', `a backfill of ${source} is running; it is reading the same history`);
+        return await run(source, tokens, env, lock, o);
+    }
+    finally {
+        lock.release();
+    }
+}
+async function run(source, tokens, env, lock, o) {
+    const now = env.now();
+    const nowIso = now.toISOString();
+    let scope = await env.scopeOf(source, { trigger: o.trigger });
+    // A source that must not be read until the person acts (Confluence with no spaces): no request, no row, the command to run.
+    if (scope.blocked !== undefined)
+        return none(source, 'manual', scope.blocked);
+    if (scope.activates && scope.disclosure !== undefined) {
+        // An agent's waiting scope offered to a person: it is read only after an explicit Yes. Anything else reads what was in force.
+        env.announce?.(source, scope.disclosure);
+        const yes = env.announce !== undefined && env.confirm !== undefined && await env.confirm(source, `Read ${describeScopeKey(source, scope.scopeKey, 'team')} now? No keeps your current scope.`);
+        if (yes)
+            env.markDisclosed?.(source, scope.scopeKey);
+        else
+            scope = await env.scopeOf(source, { trigger: 'background' });
+        if (scope.blocked !== undefined)
+            return none(source, 'manual', scope.blocked);
+    }
+    else if (scope.disclosure !== undefined && env.announce) {
+        env.announce(source, scope.disclosure);
+        env.markDisclosed?.(source, scope.scopeKey);
+    }
+    const key = { source, scopeKey: scope.scopeKey, scope: scope.scope };
+    const rows = readRows(env.dbPath, source);
+    // A new scope inherits the depth the person asked for on this source ("all" stays all).
+    const row = beginRun(env.dbPath, key, inheritedWindowSince(rows, now), nowIso);
+    if (row.status === 'needs_reauth') {
+        return { ...none(source, 'needs_reauth', `${source} needs the person to re-authenticate. Run: align connect ${source}`), scope: scope.scope };
+    }
+    const win = nextWindow(row, now);
+    const skips = [];
+    let hotThreads;
+    if (source === 'slack' && win.since !== undefined) {
+        const sel = selectHotThreads(threadRows(env.dbPath, 'slack'), now);
+        if (sel.hot.length > 0)
+            hotThreads = sel.hot;
+        if (sel.quiet > 0) {
+            skips.push({ kind: 'shape', count: sel.quiet, detail: `threads quiet for more than ${HOT_THREAD_DAYS} days are not re-read, so a late reply to one is not picked up` });
+        }
+    }
+    let fetched;
+    try {
+        fetched = await env.fetch(source, tokens, { ...win, ...(hotThreads ? { hotThreads } : {}) }, scope);
+    }
+    catch (e) {
+        return failed(source, key, row.window_since, env, e);
+    }
+    const { items, report } = fetched;
+    // Only a THROWN refusal of the token (above) marks a source needs_reauth. An auth SKIP is one repo, one channel or one
+    // project the token cannot see: it stays a skip of this scope and blocks nothing else.
+    skips.push(...report.skips);
+    const complete = report.complete === true;
+    // A cut needs ONE newest-first listing AND nothing but cut-kind skips beside it: any error, auth or other skip means
+    // something was unreadable in a place no date describes, and that makes the whole run a hole (see CUT_KINDS_BY_SOURCE).
+    const cutKinds = CUT_KINDS_BY_SOURCE[source];
+    const cut = !complete && cutKinds !== undefined && report.oldestReached !== undefined
+        && report.skips.every((k) => k.kind === 'shape' || (k.kind !== undefined && cutKinds.has(k.kind)));
+    const holeSkips = complete || cut ? [] : report.skips.filter((k) => k.kind !== 'shape');
+    const holeSig = holeSkips.length === 0 ? null : [...new Set(holeSkips.map((k) => `${k.kind}: ${k.detail.replace(/\d+/g, '#')}`))].sort().join(' | ').slice(0, 400);
+    const holeStreak = holeSig === null ? 0 : holeSig === row.hole_sig ? row.hole_streak + 1 : 1;
+    const persistent = holeStreak >= PERSISTENT_HOLE_RUNS;
+    const lostLock = () => none(source, 'locked', 'stopped: another sync took over this source while this one was paused. Nothing more was written.');
+    const size = env.batchSize ?? BATCH;
+    const wholeReads = { deadline: now.getTime() + WHOLE_THREAD_BUDGET_MS, kept: 0 };
+    const ordered = ascendingByUpdated(items);
+    let created = 0;
+    let updated = 0;
+    try {
+        for (let at = 0; at < ordered.length; at += size) {
+            // A holder that slept past the lock's lifetime may no longer be THE holder: check before every batch.
+            if (!lock.owned())
+                return lostLock();
+            const batch = ordered.slice(at, at + size);
+            const texts = await prepareBatch(env, tokens, batch, wholeReads);
+            const { snapshots } = await env.client.ingestBatch(batch.map((item, i) => ({
+                source_url: item.source_url, platform: item.platform, ...texts[i],
+                ...(item.created_at !== undefined ? { created_at: item.created_at } : {}),
+                ...(item.detail_pending === true ? { detail_pending: true } : {}),
+            })), { classify: false, keyed: true });
+            for (const s of snapshots) {
+                if (s.created)
+                    created += 1;
+                else if (s.changed)
+                    updated += 1;
+            }
+            recordActivity(env.dbPath, key.scopeKey, batch.flatMap((item, i) => (plausible(item.updated_at, now) !== undefined && snapshots[i] ? [{ decisionId: snapshots[i].id, platform: item.platform, updatedAt: item.updated_at }] : [])));
+            // Oldest first, so every older item is committed: this stamp is safe to resume from. Only a
+            // complete read may move it; an incomplete one is settled by finishRun once the cycle ends.
+            const committed = newestUpdated(batch, now);
+            if (complete && committed !== undefined)
+                advanceHighWater(env.dbPath, key, committed, now);
+            lock.touch();
+        }
+    }
+    catch (e) {
+        return failed(source, key, row.window_since, env, e, { created, updated, read: items.length });
+    }
+    if (wholeReads.kept > 0) {
+        skips.push({ kind: 'shape', count: wholeReads.kept, detail: `thread${wholeReads.kept === 1 ? '' : 's'} kept as partial and merged by appending: the whole thread could not be re-read (${wholeReads.reason ?? 'unknown'})` });
+    }
+    if (!lock.owned())
+        return lostLock();
+    // The row as it stands now: batches of a complete read have moved high_water already.
+    const current = readRows(env.dbPath, source).find((r) => r.scope_key === key.scopeKey) ?? row;
+    const fin = finishRun({ high_water: current.high_water, pending_until: row.pending_until }, {
+        complete, cut, persistent,
+        ...(report.highWater !== undefined ? { highWater: report.highWater } : {}),
+        ...(report.oldestReached !== undefined ? { oldestReached: report.oldestReached } : {}),
+        // The last run of a cycle a ceiling split: its own highWater is clamped to its `until`, so the
+        // cycle's top comes from THIS scope's own row, never from another scope's items.
+        ...(row.pending_until !== null && row.cycle_top !== null ? { cycleNewest: row.cycle_top } : {}),
+        now,
+    });
+    const cycleTop = cut ? later(row.cycle_top, plausible(report.highWater, now)) : null;
+    const persist = (more) => saveRun(env.dbPath, key, {
+        ...fin, cycle_top: cycleTop, hole_sig: holeSig, hole_streak: holeStreak, items: items.length, skips: [...skips, ...more],
+        attemptAt: env.now().toISOString(),
+        // Success is a COMPLETE read. A partial one is an attempt, and must not make the source look freshly synced.
+        ...(fin.status === 'ok' ? { successAt: env.now().toISOString() } : {}),
+    });
+    persist([]);
+    let drain;
+    if (source === 'github') {
+        const elapsed = env.now().getTime() - now.getTime();
+        const deadlineMs = Math.max(30_000, SYNC_TIME_BUDGET_MS - elapsed);
+        drain = await (env.drain ? env.drain(tokens['token'], deadlineMs) : drainGitHub(env.dbPath, env.client, tokens['token'], { deadlineMs }));
+        if (drain.skips.length > 0)
+            persist(drain.skips);
+    }
+    return {
+        source, state: fin.status, read: items.length, created, updated, skips: [...skips, ...(drain?.skips ?? [])], scope: scope.scope,
+        ...(win.since !== undefined ? { since: win.since } : {}),
+        ...(cut && report.oldestReached !== undefined ? { reachedBack: report.oldestReached } : {}),
+        ...(drain ? { drain } : {}),
+        ...(persistent && holeSig !== null ? { persistentHole: holeSig } : {}),
+        ...(report.scopeNote ? { scopeNote: report.scopeNote } : {}),
+        ...(scope.note !== undefined ? { scopeLine: scope.note } : {}),
+    };
+}
+/** Whole-thread re-reads run three at a time, and all of a run's together get this long, outside the SDK's own budget. */
+const WHOLE_THREAD_CONCURRENCY = 3;
+const WHOLE_THREAD_BUDGET_MS = 90_000;
+async function prepareBatch(env, tokens, batch, whole) {
+    const out = [];
+    for (let at = 0; at < batch.length; at += WHOLE_THREAD_CONCURRENCY) {
+        out.push(...await Promise.all(batch.slice(at, at + WHOLE_THREAD_CONCURRENCY).map((item) => prepared(env, tokens, item, whole))));
+    }
+    return out;
+}
+async function prepared(env, tokens, item, whole) {
+    if (item.partial !== true || !MERGEABLE.has(item.platform))
+        return { raw_text: item.raw_text, title: item.title };
+    const key = item.source_key ?? connectorItemKey(item.platform, item.source_url);
+    const stored = key === undefined ? undefined : storedByKey(env.dbPath, key.startsWith(`${item.platform}|`) ? key : `${item.platform}|${key}`);
+    if (stored === undefined)
+        return { raw_text: item.raw_text, title: item.title };
+    const merge = () => ({ raw_text: mergePartialThread(stored.summary, item.raw_text), title: stored.title });
+    // The text carries no message times or authors, so an EDITED message cannot be told from a new one by
+    // comparing lines. When the thread can be read whole (one or two requests), the whole thread replaces the
+    // stored one; only a thread that cannot be read whole is merged by appending, and every such fallback is counted.
+    if (env.fetchWhole === undefined)
+        return merge();
+    if (env.now().getTime() > whole.deadline) {
+        whole.kept += 1;
+        whole.reason ??= 'the time allowed for re-reading whole threads ran out';
+        return merge();
+    }
+    try {
+        const full = await env.fetchWhole(item.platform, tokens, item.source_url);
+        if (full === undefined)
+            return merge(); // this platform has no whole-thread read: nothing was attempted
+        if (full.partial !== true)
+            return { raw_text: full.raw_text, title: stored.title };
+        whole.kept += 1;
+        whole.reason ??= 'the thread is longer than one read returns';
+    }
+    catch (e) {
+        whole.kept += 1;
+        whole.reason ??= (e instanceof Error ? e.message : String(e)).slice(0, 100);
+    }
+    return merge();
+}
+function failed(source, key, window, env, e, partial) {
+    const message = (e instanceof Error ? e.message : String(e)).slice(0, 200);
+    const row = readRows(env.dbPath, source).find((r) => r.scope_key === key.scopeKey);
+    if (isAuthExpiry(e)) {
+        markNeedsReauth(env.dbPath, key, window, env.now().toISOString());
+        saveRun(env.dbPath, key, { status: 'needs_reauth', high_water: row?.high_water ?? null, pending_until: row?.pending_until ?? null, cycle_top: row?.cycle_top ?? null, hole_sig: row?.hole_sig ?? null, hole_streak: row?.hole_streak ?? 0, attemptAt: env.now().toISOString(), items: 0, skips: [{ kind: 'auth', count: 1, detail: message }] });
+        return { ...none(source, 'needs_reauth', `${source} refused the saved token (${message}). Run: align connect ${source}`), skips: [{ kind: 'auth', count: 1, detail: message }], scope: key.scope };
+    }
+    const skip = { kind: 'error', count: 1, detail: message };
+    saveRun(env.dbPath, key, { status: 'error', high_water: row?.high_water ?? null, pending_until: row?.pending_until ?? null, cycle_top: row?.cycle_top ?? null, hole_sig: row?.hole_sig ?? null, hole_streak: row?.hole_streak ?? 0, attemptAt: env.now().toISOString(), items: partial?.read ?? 0, skips: [skip] });
+    return { source, state: 'error', read: partial?.read ?? 0, created: partial?.created ?? 0, updated: partial?.updated ?? 0, skips: [skip], message, scope: key.scope };
+}
+//# sourceMappingURL=run-source.js.map

package/dist/lib/sync/run-source.js.map

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

package/dist/lib/sync/safe-read.d.ts

@@ -0,0 +1,4 @@
+export declare function readRegularFile(file: string, maxBytes?: number): string | undefined;
+/** What is at this path: 'none', a regular file, or something else (a directory, a FIFO, a link) that a claim must not be built on. */
+export declare function kindAt(file: string): 'none' | 'file' | 'other';
+//# sourceMappingURL=safe-read.d.ts.map

package/dist/lib/sync/safe-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-read.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/safe-read.ts"],"names":[],"mappings":"AAOA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,GAAG,SAAS,CActF;AAED,uIAAuI;AACvI,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAO9D"}

package/dist/lib/sync/safe-read.js

@@ -0,0 +1,40 @@
+/**
+ * Read a small file the launch path does not control (the state directory is writable by anything running as the user,
+ * so a FIFO or a link can sit where a file is expected). Opens without following a link and without blocking, requires a
+ * REGULAR file, and caps the size. Anything else reads as "not there": the launcher then does nothing, and never hangs.
+ */
+import fs from 'node:fs';
+export function readRegularFile(file, maxBytes = 1_048_576) {
+    let fd;
+    try {
+        // Read inside the function, not at import: this module is on the launch path.
+        const C = fs.constants;
+        fd = fs.openSync(file, C.O_RDONLY | (C.O_NONBLOCK ?? 0) | (C.O_NOFOLLOW ?? 0));
+        const st = fs.fstatSync(fd);
+        if (!st.isFile() || st.size > maxBytes)
+            return undefined;
+        return fs.readFileSync(fd, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch { /* nothing to close */ }
+        }
+    }
+}
+/** What is at this path: 'none', a regular file, or something else (a directory, a FIFO, a link) that a claim must not be built on. */
+export function kindAt(file) {
+    try {
+        const st = fs.lstatSync(file);
+        return st.isFile() ? 'file' : 'other';
+    }
+    catch (e) {
+        return e.code === 'ENOENT' ? 'none' : 'other';
+    }
+}
+//# sourceMappingURL=safe-read.js.map

package/dist/lib/sync/safe-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-read.js","sourceRoot":"","sources":["../../../src/lib/sync/safe-read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAQ,GAAG,SAAS;IAChE,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,8EAA8E;QAC9E,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QACvB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzD,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YAAC,IAAI,CAAC;gBAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,uIAAuI;AACvI,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAQ,CAAuB,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,CAAC;AACH,CAAC"}