@aligndottech/cli 0.49.0 → 0.50.0

package/dist/lib/sync/real-env.d.ts

@@ -0,0 +1,208 @@
+import type { SyncEnv } from './run-source.js';
+import type { StatusDeps } from './status.js';
+/** The local graph this machine syncs into, or undefined when local mode is not set up. Never creates it. */
+export declare function localGraphPath(config?: {
+    getEnvironment(env: import("../config.js").EnvName): import("../config.js").EnvironmentConfig;
+    setAuthToken(env: import("../config.js").EnvName, token: string): void;
+    setTenantId(env: import("../config.js").EnvName, tenantId: string): void;
+    setNgrokUrl(url: string): void;
+    setDefaultEnv(env: import("../config.js").EnvName): void;
+    getDefaultEnv(): import("../config.js").EnvName;
+    getConnectorToken(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorToken(env: import("../config.js").EnvName, connectorKey: string, token: string): void;
+    getConnectorFields(env: import("../config.js").EnvName, connectorKey: string): Record<string, string> | null;
+    saveConnectorFields(env: import("../config.js").EnvName, connectorKey: string, fields: Record<string, string>): void;
+    forgetConnector(env: import("../config.js").EnvName, connectorKey: string): void;
+    forgetAllConnectors(env: import("../config.js").EnvName): void;
+    getConnectorCloudId(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorCloudId(env: import("../config.js").EnvName, connectorKey: string, cloudId: string): void;
+    getConnectorSiteBase(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorSiteBase(env: import("../config.js").EnvName, connectorKey: string, siteBase: string): void;
+    getConnectorScope(env: import("../config.js").EnvName, connectorKey: string): import("../scope-values.js").StoredScope | null;
+    setConnectorScope(env: import("../config.js").EnvName, connectorKey: string, scope: import("../scope-values.js").StoredScope): void;
+    clearConnectorScope(env: import("../config.js").EnvName, connectorKey: string): void;
+    clearTeamScopeDisclosed(source: string): void;
+    getTeamScopeDisclosedFor(): string[];
+    isTeamScopeDisclosed(source: string, scopeKey: string): boolean;
+    markTeamScopeDisclosed(source: string, scopeKey: string): void;
+    setLocalMode(dbPath: string): void;
+    clearLocalMode(): void;
+    clear(env: import("../config.js").EnvName): void;
+    getInstallId(): string;
+    getAgent(): string | undefined;
+    setAgent(agent: string): void;
+    isLaunchOff(): boolean;
+    setLaunchOff(off: boolean): void;
+    clearAgent(): void;
+    isBackgroundSyncOff(): boolean;
+    setBackgroundSyncOff(off: boolean): void;
+    backgroundSyncNoticeShown(): boolean;
+    markBackgroundSyncNoticeShown(at: string): void;
+    getReauthLineShownAt(): string | undefined;
+    markReauthLineShown(at: string): void;
+    getWrittenConfigs(): Record<string, import("../safe-config-write.js").WrittenConfig>;
+    recordWrittenConfig(file: string, entry: import("../safe-config-write.js").WrittenConfig): void;
+    dropWrittenConfigs(files: string[]): void;
+    wasWriteRefused(file: string): boolean;
+    unmarkWriteRefused(file: string): void;
+    clearRefusedWrites(): void;
+    markWriteRefused(file: string): void;
+    getTelemetryConsent(): import("../config.js").TelemetryConsent | undefined;
+    setTelemetryConsent(value: import("../config.js").TelemetryConsent): void;
+    setTelemetryOffByEnv(via: string, now?: Date): void;
+    getTelemetryOffByEnv(): {
+        via: string;
+        at: string;
+    } | undefined;
+    getTelemetryNoticeShownAt(): string | undefined;
+    markTelemetryNoticeShown(): void;
+    getProviderKey(provider: import("../config.js").GuidedProviderKey): string | null;
+    setProviderKey(provider: import("../config.js").GuidedProviderKey, key: string): void;
+    clearProviderKey(provider: import("../config.js").GuidedProviderKey): void;
+    getLlmPreference(): import("../config.js").LlmPreference;
+    setLlmPreference(pref: import("../config.js").LlmPreference): void;
+    clearLlmPreference(): void;
+    isAskKeyOfferDismissed(): boolean;
+    setAskKeyOfferDismissed(dismissed: boolean): void;
+    wasFunnelStageRecorded(stage: string): boolean;
+    claimFunnelStage(stage: string): boolean;
+    releaseFunnelStage(stage: string): boolean;
+    markFunnelStageRecorded(stage: string): void;
+}): string | undefined;
+export declare function realSyncEnv(dbPath: string, config?: {
+    getEnvironment(env: import("../config.js").EnvName): import("../config.js").EnvironmentConfig;
+    setAuthToken(env: import("../config.js").EnvName, token: string): void;
+    setTenantId(env: import("../config.js").EnvName, tenantId: string): void;
+    setNgrokUrl(url: string): void;
+    setDefaultEnv(env: import("../config.js").EnvName): void;
+    getDefaultEnv(): import("../config.js").EnvName;
+    getConnectorToken(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorToken(env: import("../config.js").EnvName, connectorKey: string, token: string): void;
+    getConnectorFields(env: import("../config.js").EnvName, connectorKey: string): Record<string, string> | null;
+    saveConnectorFields(env: import("../config.js").EnvName, connectorKey: string, fields: Record<string, string>): void;
+    forgetConnector(env: import("../config.js").EnvName, connectorKey: string): void;
+    forgetAllConnectors(env: import("../config.js").EnvName): void;
+    getConnectorCloudId(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorCloudId(env: import("../config.js").EnvName, connectorKey: string, cloudId: string): void;
+    getConnectorSiteBase(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorSiteBase(env: import("../config.js").EnvName, connectorKey: string, siteBase: string): void;
+    getConnectorScope(env: import("../config.js").EnvName, connectorKey: string): import("../scope-values.js").StoredScope | null;
+    setConnectorScope(env: import("../config.js").EnvName, connectorKey: string, scope: import("../scope-values.js").StoredScope): void;
+    clearConnectorScope(env: import("../config.js").EnvName, connectorKey: string): void;
+    clearTeamScopeDisclosed(source: string): void;
+    getTeamScopeDisclosedFor(): string[];
+    isTeamScopeDisclosed(source: string, scopeKey: string): boolean;
+    markTeamScopeDisclosed(source: string, scopeKey: string): void;
+    setLocalMode(dbPath: string): void;
+    clearLocalMode(): void;
+    clear(env: import("../config.js").EnvName): void;
+    getInstallId(): string;
+    getAgent(): string | undefined;
+    setAgent(agent: string): void;
+    isLaunchOff(): boolean;
+    setLaunchOff(off: boolean): void;
+    clearAgent(): void;
+    isBackgroundSyncOff(): boolean;
+    setBackgroundSyncOff(off: boolean): void;
+    backgroundSyncNoticeShown(): boolean;
+    markBackgroundSyncNoticeShown(at: string): void;
+    getReauthLineShownAt(): string | undefined;
+    markReauthLineShown(at: string): void;
+    getWrittenConfigs(): Record<string, import("../safe-config-write.js").WrittenConfig>;
+    recordWrittenConfig(file: string, entry: import("../safe-config-write.js").WrittenConfig): void;
+    dropWrittenConfigs(files: string[]): void;
+    wasWriteRefused(file: string): boolean;
+    unmarkWriteRefused(file: string): void;
+    clearRefusedWrites(): void;
+    markWriteRefused(file: string): void;
+    getTelemetryConsent(): import("../config.js").TelemetryConsent | undefined;
+    setTelemetryConsent(value: import("../config.js").TelemetryConsent): void;
+    setTelemetryOffByEnv(via: string, now?: Date): void;
+    getTelemetryOffByEnv(): {
+        via: string;
+        at: string;
+    } | undefined;
+    getTelemetryNoticeShownAt(): string | undefined;
+    markTelemetryNoticeShown(): void;
+    getProviderKey(provider: import("../config.js").GuidedProviderKey): string | null;
+    setProviderKey(provider: import("../config.js").GuidedProviderKey, key: string): void;
+    clearProviderKey(provider: import("../config.js").GuidedProviderKey): void;
+    getLlmPreference(): import("../config.js").LlmPreference;
+    setLlmPreference(pref: import("../config.js").LlmPreference): void;
+    clearLlmPreference(): void;
+    isAskKeyOfferDismissed(): boolean;
+    setAskKeyOfferDismissed(dismissed: boolean): void;
+    wasFunnelStageRecorded(stage: string): boolean;
+    claimFunnelStage(stage: string): boolean;
+    releaseFunnelStage(stage: string): boolean;
+    markFunnelStageRecorded(stage: string): void;
+}): SyncEnv;
+export declare function realStatusDeps(dbPath: string, config?: {
+    getEnvironment(env: import("../config.js").EnvName): import("../config.js").EnvironmentConfig;
+    setAuthToken(env: import("../config.js").EnvName, token: string): void;
+    setTenantId(env: import("../config.js").EnvName, tenantId: string): void;
+    setNgrokUrl(url: string): void;
+    setDefaultEnv(env: import("../config.js").EnvName): void;
+    getDefaultEnv(): import("../config.js").EnvName;
+    getConnectorToken(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorToken(env: import("../config.js").EnvName, connectorKey: string, token: string): void;
+    getConnectorFields(env: import("../config.js").EnvName, connectorKey: string): Record<string, string> | null;
+    saveConnectorFields(env: import("../config.js").EnvName, connectorKey: string, fields: Record<string, string>): void;
+    forgetConnector(env: import("../config.js").EnvName, connectorKey: string): void;
+    forgetAllConnectors(env: import("../config.js").EnvName): void;
+    getConnectorCloudId(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorCloudId(env: import("../config.js").EnvName, connectorKey: string, cloudId: string): void;
+    getConnectorSiteBase(env: import("../config.js").EnvName, connectorKey: string): string | null;
+    setConnectorSiteBase(env: import("../config.js").EnvName, connectorKey: string, siteBase: string): void;
+    getConnectorScope(env: import("../config.js").EnvName, connectorKey: string): import("../scope-values.js").StoredScope | null;
+    setConnectorScope(env: import("../config.js").EnvName, connectorKey: string, scope: import("../scope-values.js").StoredScope): void;
+    clearConnectorScope(env: import("../config.js").EnvName, connectorKey: string): void;
+    clearTeamScopeDisclosed(source: string): void;
+    getTeamScopeDisclosedFor(): string[];
+    isTeamScopeDisclosed(source: string, scopeKey: string): boolean;
+    markTeamScopeDisclosed(source: string, scopeKey: string): void;
+    setLocalMode(dbPath: string): void;
+    clearLocalMode(): void;
+    clear(env: import("../config.js").EnvName): void;
+    getInstallId(): string;
+    getAgent(): string | undefined;
+    setAgent(agent: string): void;
+    isLaunchOff(): boolean;
+    setLaunchOff(off: boolean): void;
+    clearAgent(): void;
+    isBackgroundSyncOff(): boolean;
+    setBackgroundSyncOff(off: boolean): void;
+    backgroundSyncNoticeShown(): boolean;
+    markBackgroundSyncNoticeShown(at: string): void;
+    getReauthLineShownAt(): string | undefined;
+    markReauthLineShown(at: string): void;
+    getWrittenConfigs(): Record<string, import("../safe-config-write.js").WrittenConfig>;
+    recordWrittenConfig(file: string, entry: import("../safe-config-write.js").WrittenConfig): void;
+    dropWrittenConfigs(files: string[]): void;
+    wasWriteRefused(file: string): boolean;
+    unmarkWriteRefused(file: string): void;
+    clearRefusedWrites(): void;
+    markWriteRefused(file: string): void;
+    getTelemetryConsent(): import("../config.js").TelemetryConsent | undefined;
+    setTelemetryConsent(value: import("../config.js").TelemetryConsent): void;
+    setTelemetryOffByEnv(via: string, now?: Date): void;
+    getTelemetryOffByEnv(): {
+        via: string;
+        at: string;
+    } | undefined;
+    getTelemetryNoticeShownAt(): string | undefined;
+    markTelemetryNoticeShown(): void;
+    getProviderKey(provider: import("../config.js").GuidedProviderKey): string | null;
+    setProviderKey(provider: import("../config.js").GuidedProviderKey, key: string): void;
+    clearProviderKey(provider: import("../config.js").GuidedProviderKey): void;
+    getLlmPreference(): import("../config.js").LlmPreference;
+    setLlmPreference(pref: import("../config.js").LlmPreference): void;
+    clearLlmPreference(): void;
+    isAskKeyOfferDismissed(): boolean;
+    setAskKeyOfferDismissed(dismissed: boolean): void;
+    wasFunnelStageRecorded(stage: string): boolean;
+    claimFunnelStage(stage: string): boolean;
+    releaseFunnelStage(stage: string): boolean;
+    markFunnelStageRecorded(stage: string): void;
+}): StatusDeps;
+//# sourceMappingURL=real-env.d.ts.map

package/dist/lib/sync/real-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-env.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/real-env.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,6GAA6G;AAC7G,wBAAgB,cAAc,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,GAAG,MAAM,GAAG,SAAS,CAG/E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,GAAG,OAAO,CAcjF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsB,GAAG,UAAU,CAWvF"}

package/dist/lib/sync/real-env.js

@@ -0,0 +1,47 @@
+/**
+ * L5: the production wiring of `SyncEnv` and `StatusDeps`: the real config store, the real graph,
+ * the real lock directory and the real backfill status files. Kept out of the command so the
+ * command is argument handling and printing only, and out of run-source.ts so that file stays a
+ * function of its injected world.
+ */
+import { backfillDir, liveBackfills, pidAlive, readStatus, statusPath } from '../backfill-state.js';
+import { createConfigStore } from '../config.js';
+import { createLocalGatewayClient } from '../local-gateway-client.js';
+import { getLocalDbPath } from '../local-mode.js';
+import { acquireLock, lockHolder } from './lock.js';
+import { markTold } from '../scope.js';
+import { configScopeStore, realScopeDeps, scopeStatusHooks } from '../scope-real.js';
+import { fetchSource, fetchWhole, scopeOf } from './sources.js';
+/** The local graph this machine syncs into, or undefined when local mode is not set up. Never creates it. */
+export function localGraphPath(config = createConfigStore()) {
+    const env = config.getEnvironment('local');
+    return env.mode === 'local-embedded' ? (env.localDbPath ?? getLocalDbPath()) : undefined;
+}
+export function realSyncEnv(dbPath, config = createConfigStore()) {
+    const dir = backfillDir();
+    return {
+        dbPath,
+        now: () => new Date(),
+        tokens: (source) => config.getConnectorFields('local', source),
+        scopeOf: (source, o) => scopeOf(source, o, realScopeDeps(dbPath, { config })),
+        markDisclosed: (source, scopeKey) => markTold(configScopeStore(config), source, scopeKey),
+        fetch: fetchSource,
+        fetchWhole,
+        client: createLocalGatewayClient(dbPath),
+        lock: (name) => acquireLock(name),
+        backfillRunning: (source) => dir !== null && liveBackfills(dir).some((s) => s.source === source),
+    };
+}
+export function realStatusDeps(dbPath, config = createConfigStore()) {
+    return {
+        dbPath, ...scopeStatusHooks(config),
+        isConnected: (id) => Boolean(config.getConnectorFields('local', id)?.['token']),
+        syncRunning: (id) => lockHolder(`sync-${id}`) !== undefined,
+        backfill: (id) => {
+            const dir = backfillDir();
+            return dir ? readStatus(statusPath(dir, id)) : null;
+        },
+        backfillAlive: (s) => s.state === 'running' && pidAlive(s.pid),
+    };
+}
+//# sourceMappingURL=real-env.js.map

package/dist/lib/sync/real-env.js.map

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

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

@@ -0,0 +1,14 @@
+import type { createLocalGatewayClient } from '../local-gateway-client.js';
+export interface RelinkResult {
+    linked: number;
+    embedded: number;
+    skipped: number;
+}
+export declare function relinkAll(dbPath: string, client: Pick<ReturnType<typeof createLocalGatewayClient>, 'relinkUnfinished'>, o?: {
+    deadlineAt?: number;
+    now?: () => number;
+    batch?: number;
+}): Promise<RelinkResult & {
+    timedOut: boolean;
+}>;
+//# sourceMappingURL=relink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relink.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/relink.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAG3E,MAAM,WAAW,YAAY;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAInF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,EAAE,kBAAkB,CAAC,EAC7E,CAAC,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,OAAO,CAAC,YAAY,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAiB/C"}

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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"}