@aligndottech/cli 0.48.0 → 0.50.0

package/dist/lib/sync/should-background-sync.d.ts

@@ -0,0 +1,31 @@
+import type { SyncSummary } from './summary-read.js';
+/** Decision 23: at most one background read per source per 15 minutes. One constant. */
+export declare const SYNC_MIN_INTERVAL_MS: number;
+/** The child waits this long before its first request, so it does not compete with the agent's own start-up. */
+export declare const BACKGROUND_LAUNCH_DELAY_SECONDS = 20;
+/** The "reconnect this source" line is shown at most this often. */
+export declare const REAUTH_LINE_INTERVAL_MS: number;
+export interface BackgroundSyncGates {
+    isTty: boolean;
+    /** Already inside a launched agent (ALIGN_WRAPPED). */
+    wrapped: boolean;
+    /** ALIGN_NO_SYNC. */
+    noSync: boolean;
+    ci: boolean;
+    /** `align sync --off`. */
+    disabled: boolean;
+    summary: SyncSummary | undefined;
+    now: number;
+}
+export interface BackgroundSyncInput extends BackgroundSyncGates {
+    minIntervalMs: number;
+    /** Sources with a sync or a backfill running right now. */
+    busy?: ReadonlySet<string>;
+}
+export declare function shouldBackgroundSync(i: BackgroundSyncInput): string[];
+/** Eligible sources whose token stopped working, when the "reconnect" line is due. Same gates as the spawn. */
+export declare function reauthSources(i: BackgroundSyncGates & {
+    lastShownAt: string | undefined;
+    intervalMs: number;
+}): string[];
+//# sourceMappingURL=should-background-sync.d.ts.map

package/dist/lib/sync/should-background-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"should-background-sync.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/should-background-sync.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEpE,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,QAAc,CAAC;AAChD,gHAAgH;AAChH,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AAKtD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,0BAA0B;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B;AA4BD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAcrE;AAED,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,CAAC,EAAE,mBAAmB,GAAG;IAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAKxH"}

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

@@ -0,0 +1,69 @@
+/**
+ * L6 (Decisions 8, 9, 23): the launch decision, pure. It reads nothing itself: the caller hands in
+ * what `sync-summary.json` said, so the launch path opens no database, makes no network call and
+ * loads no fetcher to decide. Every gate fails toward "do not start anything".
+ */
+import { isKnownSource } from './source-ids.js';
+/** Decision 23: at most one background read per source per 15 minutes. One constant. */
+export const SYNC_MIN_INTERVAL_MS = 15 * 60_000;
+/** The child waits this long before its first request, so it does not compete with the agent's own start-up. */
+export const BACKGROUND_LAUNCH_DELAY_SECONDS = 20;
+/** The "reconnect this source" line is shown at most this often. */
+export const REAUTH_LINE_INTERVAL_MS = 24 * 3_600_000;
+/** What reaches argv. The summary is a file on disk, so an id must be one of the sources a sync reads (which also rules out a flag or a second word). */
+const SAFE_SOURCE_ID = { test: isKnownSource };
+function gatesClosed(i) {
+    return !i.isTty || i.wrapped || i.noSync || i.ci || i.disabled || !i.summary;
+}
+function parsed(iso) {
+    if (iso === undefined)
+        return undefined;
+    const t = Date.parse(iso);
+    return Number.isNaN(t) ? undefined : t;
+}
+/**
+ * The latest moment this source was tried, or undefined when no readable timestamp exists. A stamp
+ * LATER than now is ignored (a clock that moved back, or a damaged file): otherwise it would read
+ * as "tried in the future" and, with the age negative, make the source due on every launch. When
+ * every stamp is in the future the source counts as tried when the summary was written, so it is
+ * retried once the interval has passed, not on every launch.
+ */
+function lastTried(s, now, generatedAt) {
+    const all = [parsed(s.lastSuccessAt), parsed(s.lastAttemptAt)].filter((t) => t !== undefined);
+    const past = all.filter((t) => t <= now);
+    if (past.length > 0)
+        return Math.max(...past);
+    if (all.length === 0)
+        return undefined;
+    const written = parsed(generatedAt);
+    return written !== undefined && written <= now ? written : undefined;
+}
+export function shouldBackgroundSync(i) {
+    if (gatesClosed(i))
+        return [];
+    const due = new Set();
+    for (const s of i.summary.sources) {
+        // `never`: connected but never read by a person (no manual sync or backfill yet), so nothing is read unattended for it.
+        // `manual` and `not_connected`: a run cannot get further until a person acts, and writes no timestamp, so it would respawn every interval.
+        if (!s.backgroundEligible || s.status === 'needs_reauth' || s.status === 'never' || s.status === 'manual' || s.status === 'not_connected')
+            continue;
+        if (!SAFE_SOURCE_ID.test(s.id) || i.busy?.has(s.id))
+            continue;
+        const tried = lastTried(s, i.now, i.summary.generated_at);
+        // No readable timestamp: stale, never fresh.
+        const age = tried === undefined ? Number.POSITIVE_INFINITY : i.now - tried;
+        if (age >= i.minIntervalMs)
+            due.add(s.id);
+    }
+    return [...due];
+}
+/** Eligible sources whose token stopped working, when the "reconnect" line is due. Same gates as the spawn. */
+export function reauthSources(i) {
+    if (gatesClosed(i))
+        return [];
+    const shown = parsed(i.lastShownAt);
+    if (shown !== undefined && i.now - shown >= 0 && i.now - shown < i.intervalMs)
+        return [];
+    return [...new Set(i.summary.sources.filter((s) => s.backgroundEligible && s.status === 'needs_reauth' && SAFE_SOURCE_ID.test(s.id)).map((s) => s.id))];
+}
+//# sourceMappingURL=should-background-sync.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * The sources a sync can read, in a module with no imports so the launch path may name them
+ * (mcp-backfill.ts re-exports it; localConnectorIds() equals it by test). One list: the launcher
+ * filters a summary file's ids against it, and the sync command refuses (or, in the background,
+ * skips) anything else.
+ */
+export declare const KNOWN_SOURCES: readonly ["github", "jira", "confluence", "slack", "teams", "gitlab", "linear", "notion"];
+export type KnownSource = (typeof KNOWN_SOURCES)[number];
+export declare const isKnownSource: (id: string) => id is KnownSource;
+//# sourceMappingURL=source-ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-ids.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/source-ids.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,2FAA4F,CAAC;AACvH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,KAAG,EAAE,IAAI,WAAgE,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * The sources a sync can read, in a module with no imports so the launch path may name them
+ * (mcp-backfill.ts re-exports it; localConnectorIds() equals it by test). One list: the launcher
+ * filters a summary file's ids against it, and the sync command refuses (or, in the background,
+ * skips) anything else.
+ */
+export const KNOWN_SOURCES = ['github', 'jira', 'confluence', 'slack', 'teams', 'gitlab', 'linear', 'notion'];
+export const isKnownSource = (id) => KNOWN_SOURCES.includes(id);
+//# sourceMappingURL=source-ids.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-ids.js","sourceRoot":"","sources":["../../../src/lib/sync/source-ids.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEvH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAU,EAAqB,EAAE,CAAE,aAAmC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * L5: how a sync reads one source. The connectors that `align connect` already knows how to read
+ * keep their one definition in setup.ts (`buildSources`): this file only adds the two things a
+ * sync needs that connect does not, a scope key per source and GitHub's items-only list read.
+ * Imported only by the sync command (it pulls setup.ts in); the MCP server never loads it.
+ */
+import type { CaptureFetchResult } from '../fetchers/capture.js';
+import { type ResolvedScope, type ScopeDeps } from '../scope.js';
+/**
+ * The scope a run reads a source under (L4: scope.ts decides). `blocked` means do not read at all; `note` is worth saying to the
+ * person; `disclosure` is the one-time team-scope line, set only for a foreground run (the sync prints it before the first request).
+ */
+export type SyncScope = Pick<ResolvedScope, 'scopeKey' | 'scope'> & Partial<Pick<ResolvedScope, 'repo' | 'extras' | 'blocked' | 'note' | 'disclosure' | 'activates'>>;
+/** The scope this machine reads a source under, decided before the fetch so its watermark can be found. Chosen scopes, the folder's
+ *  repo (GitHub, GitLab) and the "yours" fallbacks are all scope.ts's: the same answer `align connect` and `align_scope` give. */
+export declare function scopeOf(source: string, o?: {
+    trigger: 'cli' | 'background';
+}, deps?: ScopeDeps): Promise<SyncScope>;
+export interface SourceWindow {
+    since?: string;
+    until?: string;
+    hotThreads?: Array<{
+        channel: string;
+        ts: string;
+    }>;
+}
+export declare function fetchSource(source: string, tokens: Record<string, string>, win: SourceWindow, scope: SyncScope): Promise<CaptureFetchResult>;
+/**
+ * Re-read one stored thread whole, for merging a partial Slack re-read without guessing which lines are new.
+ * The URL comes from a stored row, never from a person or an agent; Slack's fetchOne also holds it to a slack.com host.
+ */
+export declare function fetchWhole(source: string, tokens: Record<string, string>, url: string): Promise<CaptureFetchResult['items'][number] | undefined>;
+//# sourceMappingURL=sources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/sources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,KAAK,aAAa,EAAgB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAI/E;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC;AAEtK;kIACkI;AAClI,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAE;IAAE,OAAO,EAAE,KAAK,GAAG,YAAY,CAAA;CAAuB,EAAE,IAAI,GAAE,SAAoC,GAAG,OAAO,CAAC,SAAS,CAAC,CAEvK;AAED,MAAM,WAAW,YAAY;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE;AAErH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAWlJ;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,CAOtJ"}

package/dist/lib/sync/sources.js

@@ -0,0 +1,37 @@
+import { fetchGitHubItemsOnly } from '../fetchers/github.js';
+import { resolveScope } from '../scope.js';
+import { realScopeDeps } from '../scope-real.js';
+import { fetchWindow, windowExtras } from '../since.js';
+/** The scope this machine reads a source under, decided before the fetch so its watermark can be found. Chosen scopes, the folder's
+ *  repo (GitHub, GitLab) and the "yours" fallbacks are all scope.ts's: the same answer `align connect` and `align_scope` give. */
+export async function scopeOf(source, o = { trigger: 'cli' }, deps = realScopeDeps(undefined)) {
+    return resolveScope(source, deps, { foreground: o.trigger === 'cli' });
+}
+export async function fetchSource(source, tokens, win, scope) {
+    if (source === 'github') {
+        return fetchGitHubItemsOnly({
+            token: tokens['token'], ...fetchWindow('github', win.since !== undefined ? { since: win.since } : {}), ...windowExtras(win),
+            ...(scope.repo ? { repo: scope.repo, scope: scope.scope } : {}),
+        });
+    }
+    const { buildSources } = await import('../../commands/setup.js');
+    const def = buildSources(false).find((s) => s.id === source);
+    if (!def)
+        throw new Error(`align sync does not know how to read "${source}".`);
+    return def.fetch(tokens, win.since !== undefined ? { since: win.since } : {}, { ...windowExtras(win), ...windowExtras(scope.extras) });
+}
+/**
+ * Re-read one stored thread whole, for merging a partial Slack re-read without guessing which lines are new.
+ * The URL comes from a stored row, never from a person or an agent; Slack's fetchOne also holds it to a slack.com host.
+ */
+export async function fetchWhole(source, tokens, url) {
+    if (source !== 'slack')
+        return undefined;
+    const { SlackFetcher } = await import('@aligndottech/connector-core');
+    const r = await new SlackFetcher().fetchOne(url, { token: tokens['token'] });
+    // A skip (429, 404, a channel it cannot see, time) is a reason the caller counts, never a silent "no".
+    if (!r.item)
+        throw new Error(r.skip?.detail ?? 'the thread could not be read');
+    return r.item;
+}
+//# sourceMappingURL=sources.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../../src/lib/sync/sources.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAsB,YAAY,EAAkB,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQxD;kIACkI;AAClI,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,IAAuC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAkB,aAAa,CAAC,SAAS,CAAC;IACjJ,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;AACzE,CAAC;AAID,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,MAA8B,EAAE,GAAiB,EAAE,KAAgB;IACnH,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,oBAAoB,CAAC;YAC1B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAE,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC;YAC5H,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,IAAI,CAAC,CAAC;IAC/E,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACzI,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,MAA8B,EAAE,GAAW;IAC1F,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;IACtE,MAAM,CAAC,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAE,EAAE,CAAC,CAAC;IAC9E,uGAAuG;IACvG,IAAI,CAAC,CAAC,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,8BAA8B,CAAC,CAAC;IAC/E,OAAO,CAAC,CAAC,IAAI,CAAC;AAChB,CAAC"}

package/dist/lib/sync/spawn-background.d.ts

@@ -0,0 +1,27 @@
+import { type ChildCaller, startBackfillChild } from '../backfill-state.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 declare function syncChildArgv(sources: readonly string[], o?: {
+    delaySeconds?: number;
+}): string[];
+/**
+ * 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 declare const SYNC_CHILD_ALIGN_NAMES: readonly ["ALIGN_ENV", "ALIGN_GATEWAY_URL", "ALIGN_MODEL_CACHE", "ALIGN_TELEMETRY", "ALIGN_INGEST_CONCURRENCY", "ALIGN_DEBUG"];
+/**
+ * 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 declare function syncChildEnv(env: Record<string, string | undefined>): Record<string, string>;
+export declare function startSyncChild(sources: readonly string[], o?: {
+    delaySeconds?: number;
+    start?: typeof startBackfillChild;
+    env?: Record<string, string | undefined>;
+    caller?: ChildCaller;
+}): Promise<{
+    ok: boolean;
+    pid?: number;
+}>;
+//# sourceMappingURL=spawn-background.d.ts.map

package/dist/lib/sync/spawn-background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-background.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/spawn-background.ts"],"names":[],"mappings":"AAaA,OAAO,EAAwB,KAAK,WAAW,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAKlG,4HAA4H;AAC5H,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,EAAE,CAErG;AAUD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,gIAAiI,CAAC;AAKrK;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU5F;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,CAAC,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACnI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAKxC"}

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