@aligndottech/cli 0.49.0 → 0.51.0

package/dist/lib/sync/spawn-background.js

@@ -0,0 +1,66 @@
+/**
+ * L5: start `align sync --background ...` as a detached child (Decision 9). Used by `align_sync`
+ * (run) here, and by the launch hook and `align_backfill` later. A tool call never runs a bulk
+ * fetch in the MCP server's own process: it starts this and returns.
+ *
+ * "Started" is claimed only after the OS confirmed the child exists (startBackfillChild's rule),
+ * stdio is ignored, and the child gets its own process group (`detached`), so closing the
+ * terminal or the agent does not take it down; it finishes its current batch and exits.
+ *
+ * `caller` names who asked: 'mcp' (the default) marks the child as an agent's, so any scope it writes waits for a person; the launch hook
+ * passes 'launcher' for the person's own background refresh, which must not carry that mark.
+ */
+import os from 'node:os';
+import { backfillChildCommand, startBackfillChild } from '../backfill-state.js';
+import { CHILD_ENV_KEYS, CHILD_ENV_SECRETS, childEnvValue } from '../launch/mcp-child-env.js';
+import { PROVIDER_ENV_VARS } from '../llm-providers.js';
+import { inCi } from '../telemetry-ci.js';
+/** `--delay 0`: an on-demand run (the person or their agent just asked) has no agent start-up to stay out of the way of. */
+export function syncChildArgv(sources, o = {}) {
+    return ['sync', '--background', '--delay', String(o.delaySeconds ?? 0), ...sources];
+}
+/** Names a sync child needs that carry no secret and no routing decision: where things live. Passed as they are. */
+const PLAIN_NAMES = [
+    'PATH', 'Path', 'PATHEXT', 'HOME', 'USERPROFILE', 'HOMEDRIVE', 'HOMEPATH', 'APPDATA', 'LOCALAPPDATA', 'ProgramData',
+    'SystemRoot', 'SYSTEMROOT', 'SystemDrive', 'windir', 'COMSPEC', 'TMPDIR', 'TMP', 'TEMP', 'LANG', 'LANGUAGE', 'TZ',
+    'USER', 'USERNAME', 'LOGNAME', 'NO_COLOR',
+    // A person's own opt-out must reach the child: it sends telemetry (L7) under the same consent as the launcher.
+    'DO_NOT_TRACK',
+];
+/**
+ * The ALIGN_* names a sync child reads, and nothing else (checked against src/ by a parity test).
+ * No ALIGN_LLM_*, ALIGN_TOKEN or provider setting: a sync makes no LLM call and takes connector tokens from the config file.
+ */
+export const SYNC_CHILD_ALIGN_NAMES = ['ALIGN_ENV', 'ALIGN_GATEWAY_URL', 'ALIGN_MODEL_CACHE', 'ALIGN_TELEMETRY', 'ALIGN_INGEST_CONCURRENCY', 'ALIGN_DEBUG'];
+/** Names whose VALUE rule lives in mcp-child-env.ts (XDG dirs absolute only; proxies and certs kept unless credentialed or relative; NODE_OPTIONS always blank; CI as is). */
+const RULED_NAMES = CHILD_ENV_KEYS.filter((k) => !k.startsWith('ALIGN_') && !CHILD_ENV_SECRETS.includes(k) && !PROVIDER_ENV_VARS.includes(k));
+/**
+ * The environment a background sync child gets: an allow-list, not a copy, and the one list of
+ * value rules is mcp-child-env.ts's (so a credentialed proxy URL or a relative certificate path is
+ * dropped here exactly as it is for an MCP server). A name that is not listed is not passed, and
+ * an empty value is omitted.
+ */
+export function syncChildEnv(env) {
+    const out = {};
+    for (const k of PLAIN_NAMES) {
+        const v = env[k];
+        if (v !== undefined && v !== '')
+            out[k] = v;
+    }
+    for (const k of [...RULED_NAMES, ...SYNC_CHILD_ALIGN_NAMES]) {
+        const v = childEnvValue(k, env);
+        if (v !== '')
+            out[k] = v;
+    }
+    // The reduced env drops the CI provider's own variables (JENKINS_URL, BUILD_NUMBER...), which is how CI was recognised. Say it outright.
+    if (inCi(env))
+        out['CI'] = 'true';
+    return out;
+}
+export function startSyncChild(sources, o = {}) {
+    const argv = syncChildArgv(sources, o);
+    // The child runs from the home directory, never the folder it was started in: scope is decided by the sync layer,
+    // and an unattended run must not read a repo's remote and widen itself to that repo's team.
+    return (o.start ?? startBackfillChild)('sync', argv, undefined, backfillChildCommand(argv), o.caller ?? 'mcp', syncChildEnv(o.env ?? process.env), os.homedir());
+}
+//# sourceMappingURL=spawn-background.js.map

package/dist/lib/sync/spawn-background.js.map

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

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

@@ -0,0 +1,57 @@
+import type { BackfillStatus } from '../backfill-state.js';
+import type { SyncStatus } from './sync-state.js';
+export interface SourceStatus {
+    id: string;
+    label: string;
+    connected: boolean;
+    /** Whose items it reads: "your own items", "everyone's items in o/r". */
+    scope: string;
+    /** `blocked`: the scope in force reads nothing until the person acts (Confluence with no spaces chosen), whatever the last run said. */
+    status: SyncStatus | 'never' | 'not_connected' | 'blocked';
+    /** Stamped only by a COMPLETE run. */
+    last_success_at?: string;
+    /** Stamped by every run, complete or not. */
+    last_attempt_at?: string;
+    items_last_run?: number;
+    /** GitHub only: items still waiting for their comments and reviews. */
+    discussion_pending?: number;
+    /** Skip kinds from the last run with how many objects each covered. Never the details, never content. */
+    skips: Record<string, number>;
+    /** What the last run could not read, in the fetcher's own words, by scope. Never item content or a URL. */
+    missing?: string[];
+    /** The same hole for PERSISTENT_HOLE_RUNS runs or more: the sync reads the rest and no longer waits for it. */
+    persistent_hole?: string;
+    /** A read a ceiling cut in date order: how far back it got. Older history is still to come. */
+    reached_back_to?: string;
+    running?: 'sync' | 'backfill';
+    /** Scopes this source was read under before, kept in the graph and not read now. Absent when there are none. */
+    older_scopes?: number;
+    /** The command or note the person needs, when there is one. */
+    next_step?: string;
+}
+export interface StatusDeps {
+    dbPath: string;
+    isConnected(id: string): boolean;
+    /** Is a sync of this source running now (a live, fresh lock)? */
+    syncRunning(id: string): boolean;
+    /** The latest backfill status file for the source, if any. */
+    backfill(id: string): BackfillStatus | null;
+    backfillAlive(s: BackfillStatus): boolean;
+    /** The `source_sync.scope_key` in force for the source, when the caller can tell (the stored choice). Absent: the most recently started row. */
+    activeScopeKey?(id: string): string | undefined;
+    /** An agent's team choice waiting for a person to confirm it, in words, or undefined. */
+    pendingScope?(id: string): string | undefined;
+    /** Why a source reads nothing until the person acts, or undefined (Confluence with no spaces chosen). */
+    blockedScope?(id: string): string | undefined;
+}
+export declare const TEAMS_NOTE = "Teams: refresh manually with `align connect teams` (its token lasts about an hour). Only yours until then.";
+export declare function collectStatus(d: StatusDeps): {
+    sources: SourceStatus[];
+    rows_awaiting_relink: number;
+};
+/** Plain text for the CLI and for the `text` field of the tool result. Connected sources only. */
+export declare function renderStatus(r: {
+    sources: SourceStatus[];
+    rows_awaiting_relink: number;
+}): string;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/status.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK3D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,wIAAwI;IACxI,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;IAC3D,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yGAAyG;IACzG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,2GAA2G;IAC3G,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+GAA+G;IAC/G,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,gHAAgH;IAChH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,iEAAiE;IACjE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAC5C,aAAa,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IAC1C,gJAAgJ;IAChJ,cAAc,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,yFAAyF;IACzF,YAAY,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,yGAAyG;IACzG,YAAY,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,eAAO,MAAM,UAAU,+GAA+G,CAAC;AA6CvI,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,CAiDtG;AAED,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAwBjG"}

package/dist/lib/sync/status.js

@@ -0,0 +1,166 @@
+/**
+ * L5: what is the sync doing, per source, with no item content in it. The same facts back
+ * `align sync --status` and `align_sync({ action: 'status' })`.
+ *
+ * Reads only: the source_sync rows, two counts, the lock files and the backfill status files.
+ * It opens a short-lived read handle and never creates anything, so a tool call that asks inside
+ * an agent stays inside journey 5's 500 ms.
+ */
+import { CAPTURE_SOURCES } from '../capture-sources.js';
+import { BACKFILL_SOURCES } from '../mcp-backfill.js';
+import { describeScopeKey, labelOfScopeKey } from '../scope-values.js';
+import { EMBEDDING_MODEL_ID } from '../local-embeddings.js';
+import { PERSISTENT_HOLE_RUNS } from './window.js';
+import { pendingDetailCount, readRows, unfinishedCount } from './sync-state.js';
+export const TEAMS_NOTE = 'Teams: refresh manually with `align connect teams` (its token lasts about an hour). Only yours until then.';
+const label = (id) => CAPTURE_SOURCES[id]?.label ?? id;
+const RANK = { ok: 0, partial: 1, error: 2, needs_reauth: 3 };
+function scopeText(rows) {
+    const team = rows.filter((r) => r.scope === 'team');
+    if (team.length === 0)
+        return 'your own items';
+    return team.map((r) => describeScopeKey(r.source_id, r.scope_key, r.scope)).join('; ');
+}
+function scopeLabelOf(r) {
+    return r.scope === 'team' ? labelOfScopeKey(r.source_id, r.scope_key) : 'your own items';
+}
+/** The skips that mean something was NOT read (everything but `shape`, which is a note), with which scope they hit. */
+function missingOf(rows) {
+    const out = [];
+    for (const r of rows) {
+        if (r.skips_last_run === null)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(r.skips_last_run);
+        }
+        catch {
+            continue;
+        }
+        if (!Array.isArray(parsed))
+            continue;
+        for (const s of parsed) {
+            if (typeof s.kind !== 'string' || s.kind === 'shape' || typeof s.count !== 'number' || typeof s.detail !== 'string')
+                continue;
+            out.push(`${scopeLabelOf(r)}: ${s.count} ${s.detail.slice(0, 160)}`);
+        }
+    }
+    return out.slice(0, 5);
+}
+function skipCounts(rows) {
+    const out = {};
+    for (const r of rows) {
+        if (r.skips_last_run === null)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(r.skips_last_run);
+        }
+        catch {
+            continue;
+        }
+        if (!Array.isArray(parsed))
+            continue;
+        for (const s of parsed) {
+            if (typeof s.kind === 'string' && typeof s.count === 'number')
+                out[s.kind] = (out[s.kind] ?? 0) + s.count;
+        }
+    }
+    return out;
+}
+export function collectStatus(d) {
+    const all = readRows(d.dbPath);
+    const sources = BACKFILL_SOURCES.map((id) => {
+        const connected = d.isConnected(id);
+        const everyScope = all.filter((r) => r.source_id === id);
+        // Only the scope in force is described; the others are counted. (A refused token is refused for the whole source, so it is read off every row.)
+        const wanted = d.activeScopeKey?.(id);
+        // The fallback is the row most recently started; a row that never started, or whose stamp is not a date, cannot be "most recent" (NaN
+        // compares false both ways and would pick an arbitrary winner).
+        const started = (r) => (r.last_started_at === null ? Number.NaN : Date.parse(r.last_started_at));
+        const active = everyScope.find((r) => r.scope_key === wanted)
+            ?? [...everyScope].filter((r) => !Number.isNaN(started(r))).sort((a, b) => started(b) - started(a))[0]
+            ?? everyScope[0];
+        const rows = active ? [active] : [];
+        // A scope that never started (an agent's request waiting for a person) was never read, so it is not an "older scope kept".
+        const older = everyScope.filter((r) => !rows.includes(r) && r.last_started_at !== null).length;
+        const worst = everyScope.some((r) => r.status === 'needs_reauth') ? 'needs_reauth' : rows.reduce((w, r) => (w === undefined || RANK[r.status] > RANK[w] ? r.status : w), undefined);
+        const lasts = rows.map((r) => r.last_success_at).filter((t) => t !== null && !Number.isNaN(Date.parse(t)));
+        const last = lasts.sort((a, b) => Date.parse(b) - Date.parse(a))[0];
+        const attempts = rows.map((r) => r.last_attempt_at).filter((t) => t !== null && !Number.isNaN(Date.parse(t)));
+        const attempt = attempts.sort((a, b) => Date.parse(b) - Date.parse(a))[0];
+        const missing = missingOf(rows);
+        const stuck = rows.find((r) => r.hole_streak >= PERSISTENT_HOLE_RUNS && r.hole_sig !== null);
+        const items = rows.find((r) => r.items_last_run !== null)?.items_last_run ?? undefined;
+        const pending = rows.map((r) => r.pending_until).filter((t) => t !== null && !Number.isNaN(Date.parse(t))).sort()[0];
+        const bf = d.backfill(id);
+        const s = {
+            id, label: label(id), connected, scope: id === 'confluence' && !rows.some((r) => r.scope === 'team') ? 'no spaces chosen' : scopeText(rows),
+            status: !connected ? 'not_connected' : worst === 'needs_reauth' || d.blockedScope?.(id) === undefined ? (worst ?? 'never') : 'blocked',
+            skips: skipCounts(rows),
+            ...(last !== undefined ? { last_success_at: last } : {}),
+            ...(attempt !== undefined ? { last_attempt_at: attempt } : {}),
+            ...(missing.length > 0 ? { missing } : {}),
+            ...(stuck ? { persistent_hole: `${stuck.hole_sig} (${stuck.hole_streak} runs in a row)` } : {}),
+            ...(items !== undefined ? { items_last_run: items } : {}),
+            ...(older > 0 ? { older_scopes: older } : {}),
+            ...(pending !== undefined ? { reached_back_to: pending } : {}),
+            ...(connected && d.syncRunning(id) ? { running: 'sync' } : bf && d.backfillAlive(bf) ? { running: 'backfill' } : {}),
+        };
+        if (id === 'github' && connected)
+            s.discussion_pending = pendingDetailCount(d.dbPath, 'github');
+        if (!connected)
+            s.next_step = `Not connected. Ask the person to run: align connect ${id}`;
+        else if (s.status === 'needs_reauth')
+            s.next_step = `The provider refused the saved token. Ask the person to run: align connect ${id}`;
+        else if (s.status === 'blocked')
+            s.next_step = d.blockedScope(id);
+        else if (id === 'teams')
+            s.next_step = TEAMS_NOTE;
+        const waiting = connected ? d.pendingScope?.(id) : undefined;
+        if (waiting !== undefined)
+            s.next_step = `Team scope for ${id} is waiting for you to confirm (${waiting}): run \`align sync ${id}\` (it will show what it reads)`;
+        return s;
+    });
+    return { sources, rows_awaiting_relink: unfinishedCount(d.dbPath, EMBEDDING_MODEL_ID) };
+}
+/** Plain text for the CLI and for the `text` field of the tool result. Connected sources only. */
+export function renderStatus(r) {
+    const lines = [];
+    const connected = r.sources.filter((s) => s.connected);
+    if (connected.length === 0)
+        lines.push('No source is connected. Ask the person to run: align connect <source>');
+    for (const s of connected) {
+        const bits = [];
+        bits.push(s.status === 'never' ? 'not synced yet' : s.status);
+        if (s.running)
+            bits.push(s.running === 'sync' ? 'syncing now' : 'a backfill is running');
+        const when = (iso) => `${iso.slice(0, 16).replace('T', ' ')} UTC`;
+        if (s.last_success_at)
+            bits.push(`last complete sync ${when(s.last_success_at)}`);
+        if (s.last_attempt_at && s.last_attempt_at !== s.last_success_at && s.status !== 'ok')
+            bits.push(`last tried ${when(s.last_attempt_at)}`);
+        if (s.items_last_run !== undefined)
+            bits.push(`${s.items_last_run} items read last run`);
+        if (s.discussion_pending)
+            bits.push(`${s.discussion_pending} still waiting for their discussion`);
+        if (s.reached_back_to)
+            bits.push(`older history still to read (reached ${s.reached_back_to.slice(0, 10)})`);
+        if (s.missing)
+            bits.push(`not read last time: ${s.missing.join('; ')}`);
+        if (s.persistent_hole)
+            bits.push(`persistent hole: ${s.persistent_hole}; the sync reads the rest and no longer waits for it, so fix the access or leave it`);
+        const skips = Object.entries(s.skips).map(([k, n]) => `${k} ${n}`);
+        if (skips.length)
+            bits.push(`skipped last run: ${skips.join(', ')}`);
+        if (s.older_scopes)
+            bits.push(`${s.older_scopes} older scope${s.older_scopes === 1 ? '' : 's'} kept (not read)`);
+        lines.push(`${s.label} (${s.scope}): ${bits.join('; ')}.`);
+        if (s.next_step)
+            lines.push(`  ${s.next_step}`);
+    }
+    if (r.rows_awaiting_relink > 0)
+        lines.push(`${r.rows_awaiting_relink} stored items wait for their links to be finished. Each sync works on them for up to a minute, locally and free, until they are done.`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { SyncStatus } from './sync-state.js';
+export declare const SUMMARY_FILE = "sync-summary.json";
+export interface SummarySource {
+    id: string;
+    /** Connected, and a kind of source a background run can read (not Teams, Decision 21). */
+    backgroundEligible: boolean;
+    status: SyncStatus | 'never' | 'manual' | 'not_connected';
+    lastSuccessAt?: string;
+    /** Any run, complete or not: the launch hook spaces its attempts by this, so a source that is always partial is not retried on every launch. */
+    lastAttemptAt?: string;
+}
+export interface SyncSummary {
+    version: 1;
+    generated_at: string;
+    sources: SummarySource[];
+}
+export declare function summaryPath(dir?: string | null): string | null;
+export declare function readSummary(dir?: string | null): SyncSummary | undefined;
+//# sourceMappingURL=summary-read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary-read.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/summary-read.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,eAAO,MAAM,YAAY,sBAAsB,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,0FAA0F;IAC1F,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gJAAgJ;IAChJ,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAAG,OAAO,EAAE,CAAC,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE;AAE3F,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,GAAG,IAAsB,GAAG,MAAM,GAAG,IAAI,CAE/E;AAED,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,GAAG,IAAsB,GAAG,WAAW,GAAG,SAAS,CAgBzF"}

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

@@ -0,0 +1,39 @@
+/**
+ * L5/L6, Decision 8: the READ side of `sync-summary.json`, split out of summary.ts so the launch
+ * path can import it. summary.ts also builds the file from SQLite (sync-state.ts -> node:sqlite),
+ * and the launch path imports no database layer (launch-path-imports.test.ts). This file imports
+ * `node:fs`, `node:path` and the state-directory helper, and nothing else.
+ *
+ * Reading tolerates a missing, corrupt or foreign file by returning undefined: the launch hook
+ * then spawns nothing, which is the safe direction.
+ */
+import path from 'node:path';
+import { alignStateDir } from '../backfill-state.js';
+import { readRegularFile } from './safe-read.js';
+import { isKnownSource } from './source-ids.js';
+export const SUMMARY_FILE = 'sync-summary.json';
+export function summaryPath(dir = alignStateDir()) {
+    return dir === null ? null : path.join(dir, SUMMARY_FILE);
+}
+export function readSummary(dir = alignStateDir()) {
+    const file = summaryPath(dir);
+    if (file === null)
+        return undefined;
+    try {
+        const text = readRegularFile(file, 4_194_304);
+        if (text === undefined)
+            return undefined;
+        const raw = JSON.parse(text);
+        if (raw.version !== 1 || !Array.isArray(raw.sources) || typeof raw.generated_at !== 'string')
+            return undefined;
+        const sources = raw.sources.filter((s) => typeof s?.id === 'string' && isKnownSource(s.id) && typeof s.backgroundEligible === 'boolean');
+        // One entry per source: a repeated id would only repeat work, and a huge file is cut to the known list.
+        const seen = new Set();
+        const unique = sources.filter((s) => !seen.has(s.id) && seen.add(s.id));
+        return { version: 1, generated_at: raw.generated_at, sources: unique };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=summary-read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary-read.js","sourceRoot":"","sources":["../../../src/lib/sync/summary-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAchD,MAAM,UAAU,WAAW,CAAC,MAAqB,aAAa,EAAE;IAC9D,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAqB,aAAa,EAAE;IAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC;QACrD,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC/G,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC;QAC7J,wGAAwG;QACxG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import { type BlockedState } from './blocked.js';
+import { readSummary, SUMMARY_FILE, summaryPath, type SummarySource, type SyncSummary } from './summary-read.js';
+/** The read side lives in summary-read.ts (the launch path imports it; this file reaches SQLite). */
+export { SUMMARY_FILE, type SummarySource, type SyncSummary, readSummary, summaryPath };
+export declare function buildSummary(dbPath: string, isConnected: (id: string) => boolean, now: Date, blocked?: (id: string) => BlockedState | undefined): SyncSummary;
+/** Returns false when it could not write (an unusable state directory); nothing else depends on it. */
+export declare function writeSummary(summary: SyncSummary, dir?: string | null): boolean;
+/** Rebuild and write it. Called after a sync, and when a source is connected or forgotten. */
+export declare function refreshSummary(dbPath: string, isConnected: (id: string) => boolean, now?: Date, dir?: string | null): boolean;
+//# sourceMappingURL=summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/summary.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,cAAc,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjH,qGAAqG;AACrG,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAIxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,YAAY,GAAG,SAA2B,GAAG,WAAW,CAuB9K;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,GAAE,MAAM,GAAG,IAAsB,GAAG,OAAO,CAYhG;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,EAAE,GAAG,GAAE,IAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAMzI"}

package/dist/lib/sync/summary.js

@@ -0,0 +1,80 @@
+/**
+ * L5, Decision 8: `sync-summary.json`, the one file the launch path reads. `source_sync` in SQLite
+ * is the truth; this is a derived cache with ONE writer (the sync job and the few commands that
+ * change what is connected), so launch can decide whether to start a background sync without
+ * importing the database layer.
+ *
+ * Written atomically (a sibling file, renamed over), mode 0600, inside the private state
+ * directory. Reading tolerates a missing, corrupt or foreign file by returning undefined: the
+ * launch path then spawns nothing, which is the safe direction.
+ */
+import fs from 'node:fs';
+import { alignStateDir } from '../backfill-state.js';
+import { readBlocked } from './blocked.js';
+import { BACKFILL_SOURCES } from '../mcp-backfill.js';
+import { readRows } from './sync-state.js';
+import { readSummary, SUMMARY_FILE, summaryPath } from './summary-read.js';
+/** The read side lives in summary-read.ts (the launch path imports it; this file reaches SQLite). */
+export { SUMMARY_FILE, readSummary, summaryPath };
+const SEVERITY = { ok: 0, partial: 1, error: 2, needs_reauth: 3 };
+export function buildSummary(dbPath, isConnected, now, blocked = () => undefined) {
+    const all = readRows(dbPath);
+    const sources = [];
+    for (const id of BACKFILL_SOURCES) {
+        if (!isConnected(id))
+            continue;
+        const rows = all.filter((r) => r.source_id === id);
+        let status = 'never';
+        for (const r of rows)
+            if (status === 'never' || SEVERITY[r.status] > SEVERITY[status])
+                status = r.status;
+        let last;
+        for (const r of rows) {
+            if (r.last_success_at === null || Number.isNaN(Date.parse(r.last_success_at)))
+                continue;
+            if (last === undefined || Date.parse(r.last_success_at) > Date.parse(last))
+                last = r.last_success_at;
+        }
+        let attempt;
+        for (const r of rows) {
+            if (r.last_attempt_at === null || Number.isNaN(Date.parse(r.last_attempt_at)))
+                continue;
+            if (attempt === undefined || Date.parse(r.last_attempt_at) > Date.parse(attempt))
+                attempt = r.last_attempt_at;
+        }
+        const stuck = blocked(id);
+        if (stuck !== undefined)
+            status = stuck;
+        sources.push({ id, backgroundEligible: id !== 'teams', status, ...(last !== undefined ? { lastSuccessAt: last } : {}), ...(attempt !== undefined ? { lastAttemptAt: attempt } : {}) });
+    }
+    return { version: 1, generated_at: now.toISOString(), sources };
+}
+/** Returns false when it could not write (an unusable state directory); nothing else depends on it. */
+export function writeSummary(summary, dir = alignStateDir()) {
+    const file = summaryPath(dir);
+    if (file === null)
+        return false;
+    const tmp = `${file}.${process.pid}.tmp`;
+    try {
+        fs.writeFileSync(tmp, JSON.stringify(summary), { mode: 0o600 });
+        fs.renameSync(tmp, file);
+        return true;
+    }
+    catch {
+        try {
+            fs.rmSync(tmp, { force: true });
+        }
+        catch { /* nothing to clean */ }
+        return false;
+    }
+}
+/** Rebuild and write it. Called after a sync, and when a source is connected or forgotten. */
+export function refreshSummary(dbPath, isConnected, now = new Date(), dir) {
+    try {
+        return writeSummary(buildSummary(dbPath, isConnected, now, (id) => readBlocked(id, dir === undefined ? alignStateDir() : dir)?.state), dir);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=summary.js.map

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

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

package/dist/lib/sync/sync-state.d.ts

@@ -0,0 +1,128 @@
+import { DatabaseSync } from 'node:sqlite';
+import type { CaptureSkip } from '../fetchers/capture.js';
+export type SyncStatus = 'ok' | 'partial' | 'needs_reauth' | 'error';
+export interface SyncRow {
+    source_id: string;
+    scope_key: string;
+    scope: 'yours' | 'team';
+    window_since: string | null;
+    high_water: string | null;
+    pending_until: string | null;
+    status: SyncStatus;
+    last_started_at: string | null;
+    last_success_at: string | null;
+    /** Every run stamps this; last_success_at is stamped only by a complete one. */
+    last_attempt_at: string | null;
+    /** The newest updated_at seen across a pending cycle, in THIS scope's own row. */
+    cycle_top: string | null;
+    /** What the last incomplete run could not read (a signature), and how many runs in a row had exactly that. */
+    hole_sig: string | null;
+    hole_streak: number;
+    items_last_run: number | null;
+    skips_last_run: string | null;
+    changed_via: 'cli' | 'mcp' | null;
+    changed_by_agent: string | null;
+}
+export interface ScopeKey {
+    source: string;
+    scopeKey: string;
+    scope: 'yours' | 'team';
+}
+/** Rows of one source (every scope), or of all sources. A file that has no `source_sync` yet reads as empty. */
+export declare function readRows(dbPath: string, source?: string): SyncRow[];
+/**
+ * Open a run: create the row if the scope is new (with `defaultWindowSince` as its window - an
+ * existing row with a NULL window means "all", so a new row must never be left NULL), stamp
+ * `last_started_at`, and return the row as stored. An existing row keeps everything else.
+ */
+export declare function beginRun(dbPath: string, key: ScopeKey, defaultWindowSince: string | null, nowIso: string): SyncRow;
+/**
+ * A person (or their agent) chose a scope: give it its row NOW, with the source's window and no watermark, and attribute the
+ * change. An existing row keeps its window and its watermark - going back to a scope read before only catches up - and only
+ * its attribution moves. `created` says which. Nothing else is touched: the earlier scope's row and every stored item stay.
+ */
+export declare function adoptScope(dbPath: string, key: ScopeKey, windowSince: string | null, by: {
+    via: 'cli' | 'mcp';
+    agent: string | null;
+}): {
+    created: boolean;
+    row: SyncRow;
+};
+export interface RunResult {
+    status: SyncStatus;
+    high_water: string | null;
+    pending_until: string | null;
+    /** The cycle's newest stamp while a cycle is pending; null once it ends. */
+    cycle_top?: string | null;
+    hole_sig?: string | null;
+    hole_streak?: number;
+    /** Stamped as last_attempt_at on every run. */
+    attemptAt: string;
+    items: number;
+    skips: readonly CaptureSkip[];
+    /** Stamped as last_success_at, or left as it was when absent: only a COMPLETE run is a success. */
+    successAt?: string;
+}
+export declare function saveRun(dbPath: string, key: ScopeKey, r: RunResult): void;
+/** Move the watermark FORWARD only, from inside a run: called after a batch has committed. */
+export declare function advanceHighWater(dbPath: string, key: ScopeKey, to: string, now: Date): void;
+/**
+ * The provider refused this source's token. Every scope row of the source says so (a refused
+ * token is refused for the whole source), and a source with no row yet gets one, so the next
+ * foreground moment has something to report. The token itself is never touched here.
+ */
+export declare function markNeedsReauth(dbPath: string, key: ScopeKey, defaultWindowSince: string | null, nowIso: string): void;
+/** A fresh token was saved: the source is no longer waiting on the user. */
+export declare function clearNeedsReauth(dbPath: string, source: string): void;
+/** `align local forget <source>`: the source's sync rows go with its token. Returns how many. */
+export declare function deleteSource(dbPath: string, source: string): number;
+export declare function recordActivity(dbPath: string, scopeKey: string, entries: ReadonlyArray<{
+    decisionId: string;
+    platform: string;
+    updatedAt: string;
+}>): void;
+/** Stored items of a platform with their last known activity (null when none was recorded). */
+export declare function threadRows(dbPath: string, platform: string): Array<{
+    source_url: string;
+    last_activity: string | null;
+}>;
+/** Rows of this platform still waiting for their discussion (GitHub items-first). */
+export declare function pendingDetailCount(dbPath: string, platform: string): number;
+/** Rows whose link pass has not finished and that a re-link can finish (see unfinishedRows). */
+export declare function unfinishedCount(dbPath: string, currentModel: string): number;
+/**
+ * Ids of rows whose link pass is unfinished, oldest first, that a re-link CAN finish: it holds a
+ * current-model embedding, or it has a URL to re-ingest from (see relinkUnfinished). `keyed`
+ * says whether the row carries a source_key, so a re-ingest keeps its identity.
+ */
+export declare function unfinishedRows(dbPath: string, currentModel: string, limit: number): Array<{
+    id: string;
+    keyed: boolean;
+    pending: boolean;
+}>;
+export interface PendingRow {
+    id: string;
+    title: string;
+    summary: string;
+    source_url: string;
+    decided_at: string | null;
+}
+/** Rows of a platform still waiting for their discussion, newest first (undated last). The SDK drain sorts
+ *  what it is given as well, so this order decides only which undated rows come first. */
+export declare function pendingRows(dbPath: string, platform: string): PendingRow[];
+/** Clear the flag on exactly these rows: the ones whose discussion was just read and stored. */
+export declare function clearDetailPending(dbPath: string, ids: readonly string[]): void;
+/** The stored text of the one-item-per-URL row a fetched item belongs to, for merging a partial read into it. */
+export declare function storedByKey(dbPath: string, sourceKey: string): {
+    title: string;
+    summary: string;
+} | undefined;
+/** Run `fn` in one IMMEDIATE transaction on its own handle: all of it commits, or none of it does. */
+export declare function transact<T>(dbPath: string, fn: (db: DatabaseSync) => T): T;
+/**
+ * A run died before it could say why (a database error, the re-link queue). Record it on each
+ * source's rows so the next foreground moment and `align_sync` status can tell the person, instead of
+ * the background child vanishing without a trace. Watermarks are untouched; a source with no row gets one.
+ */
+export declare function recordRunError(dbPath: string, sources: readonly string[], message: string, nowIso: string, defaultWindowSince: string): void;
+//# sourceMappingURL=sync-state.d.ts.map