@aligndottech/cli 0.48.0 → 0.50.0

package/dist/lib/similarity/embedding-matrix.js

@@ -0,0 +1,119 @@
+/**
+ * An in-memory copy of every stored embedding, held as ONE contiguous Float32Array, with an
+ * exhaustive top-K scan over it (plan LB, decision 26).
+ *
+ * Why it exists: ingest ranked each new item against the whole graph by re-reading every
+ * stored vector out of SQLite, decoding it, and cosine-scoring it, once per item. Measured
+ * (profile at 5,000 rows): read and decode 5.7 ms, cosine 1.9 ms, sort 0.4 ms per item, and
+ * the read grows with the graph, so a batch was quadratic. Loading once per run and appending
+ * as items land removes the read; scoring against precomputed norms removes two thirds of the
+ * arithmetic. The scan stays EXHAUSTIVE - narrowing candidates would drop the cross-tool links
+ * the product exists for - so results must equal the old scan exactly. They do: the dot
+ * product accumulates in the same order as cosineSimilarity and divides by the same
+ * sqrt(normQuery) * sqrt(normRow), so every score is bit-identical, not merely close.
+ *
+ * Pure: no database, no model. The caller decides which rows go in.
+ */
+/**
+ * Above this many stored embeddings ingest does not build a matrix and ranks by streaming the
+ * table per item, as it did before the matrix existed. Memory: a 384-dim row is 1,536 bytes of
+ * Float32 plus its id and norm, so about 1.5 KB per row, i.e. roughly 230 MB at 150,000 rows.
+ * Building reads every row out of SQLite first, so the transient peak is about 2.5x the
+ * matrix (the decoded rows, the contiguous copy, and growth headroom) until the rows are
+ * released. The cap keeps that peak near 600 MB. Measured graphs are in the thousands of rows;
+ * this is a guard for the pathological case, not a tuning knob.
+ */
+export const MATRIX_MAX_ROWS = 150_000;
+/** The one writer of the "different model" error, shared with cosineSimilarity. */
+export function embeddingLengthMismatch(a, b) {
+    return new Error(`Embedding length mismatch: ${a} vs ${b}. The local graph holds a vector ` +
+        'from a different model - run `align local reset` and re-import to rebuild it.');
+}
+const INITIAL_ROWS = 256;
+export class EmbeddingMatrix {
+    dim = -1;
+    data = new Float32Array(0);
+    sqrtNorms = new Float64Array(0);
+    ids = [];
+    index = new Map();
+    static fromRows(rows) {
+        const m = new EmbeddingMatrix();
+        for (const r of rows)
+            m.add(r.decisionId, r.embedding);
+        return m;
+    }
+    get size() { return this.ids.length; }
+    /** Adds a row, or replaces the vector of an id already held (setEmbedding is INSERT OR
+     *  REPLACE, so the matrix must never hold two vectors for one decision). */
+    add(decisionId, embedding) {
+        if (this.dim === -1)
+            this.dim = embedding.length;
+        else if (embedding.length !== this.dim)
+            throw embeddingLengthMismatch(embedding.length, this.dim);
+        let row = this.index.get(decisionId);
+        if (row === undefined) {
+            row = this.ids.length;
+            if ((row + 1) * this.dim > this.data.length)
+                this.grow(Math.max(INITIAL_ROWS, row * 2));
+            this.ids.push(decisionId);
+            this.index.set(decisionId, row);
+        }
+        this.data.set(embedding, row * this.dim);
+        let norm = 0;
+        for (let i = 0; i < this.dim; i++)
+            norm += embedding[i] * embedding[i];
+        this.sqrtNorms[row] = Math.sqrt(norm);
+    }
+    /** The `k` best rows by cosine, best first; equal scores order by id in code-unit order.
+     *  Rows scoring below `threshold` are dropped (default: none are; findSimilar passed 0). */
+    topK(query, k, opts = {}) {
+        const n = this.ids.length;
+        if (n === 0 || k <= 0)
+            return [];
+        if (query.length !== this.dim)
+            throw embeddingLengthMismatch(query.length, this.dim);
+        const threshold = opts.threshold ?? -Infinity;
+        const skip = opts.excludeId === undefined ? -1 : (this.index.get(opts.excludeId) ?? -1);
+        let normQ = 0;
+        for (let i = 0; i < this.dim; i++)
+            normQ += query[i] * query[i];
+        const sqrtQ = Math.sqrt(normQ);
+        const best = [];
+        const dim = this.dim, data = this.data;
+        for (let r = 0; r < n; r++) {
+            if (r === skip)
+                continue;
+            const base = r * dim;
+            let dot = 0;
+            for (let i = 0; i < dim; i++)
+                dot += query[i] * data[base + i];
+            const denom = sqrtQ * this.sqrtNorms[r];
+            const score = denom === 0 ? 0 : dot / denom;
+            if (!(score >= threshold))
+                continue;
+            if (best.length === k && !this.outranks(score, this.ids[r], best[k - 1]))
+                continue;
+            // Insertion into a list of at most k: k is 10 in ingest, so this beats any heap.
+            let pos = best.length === k ? k - 1 : best.length;
+            while (pos > 0 && this.outranks(score, this.ids[r], best[pos - 1])) {
+                if (pos < k)
+                    best[pos] = best[pos - 1];
+                pos--;
+            }
+            best[pos] = { decisionId: this.ids[r], score };
+        }
+        return best;
+    }
+    outranks(score, id, other) {
+        return score > other.score || (score === other.score && id < other.decisionId);
+    }
+    grow(rows) {
+        const data = new Float32Array(rows * this.dim);
+        data.set(this.data);
+        this.data = data;
+        const norms = new Float64Array(rows);
+        norms.set(this.sqrtNorms);
+        this.sqrtNorms = norms;
+    }
+}
+//# sourceMappingURL=embedding-matrix.js.map

package/dist/lib/similarity/embedding-matrix.js.map

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

package/dist/lib/since-flag.d.ts

@@ -0,0 +1,11 @@
+import { type SyncWindow } from './since.js';
+/** The help line for `--since`, one writer for every command that takes it. */
+export declare const SINCE_HELP = "How far back to read: 30d, 2w, 6m, 1y or all (default 180 days). A ceiling still applies";
+/**
+ * L3: the CLI end of the one duration parser. A bad value exits 2 (usage error) naming the
+ * accepted forms, before any request is made: a window the user did not mean would be read
+ * and reported as complete. `align_backfill` calls parseSince directly and returns the same
+ * message as a tool error.
+ */
+export declare function sinceFromFlag(raw: string | undefined, now?: Date): SyncWindow;
+//# sourceMappingURL=since-flag.d.ts.map

package/dist/lib/since-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"since-flag.d.ts","sourceRoot":"","sources":["../../src/lib/since-flag.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAErE,+EAA+E;AAC/E,eAAO,MAAM,UAAU,6FAA6F,CAAC;AAErH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,UAAU,CASzF"}

package/dist/lib/since-flag.js

@@ -0,0 +1,24 @@
+import chalk from 'chalk';
+import { trackChildFromEnv } from './backfill-state.js';
+import { parseSince, SinceError } from './since.js';
+/** The help line for `--since`, one writer for every command that takes it. */
+export const SINCE_HELP = 'How far back to read: 30d, 2w, 6m, 1y or all (default 180 days). A ceiling still applies';
+/**
+ * L3: the CLI end of the one duration parser. A bad value exits 2 (usage error) naming the
+ * accepted forms, before any request is made: a window the user did not mean would be read
+ * and reported as complete. `align_backfill` calls parseSince directly and returns the same
+ * message as a tool error.
+ */
+export function sinceFromFlag(raw, now = new Date()) {
+    try {
+        return parseSince(raw, now);
+    }
+    catch (e) {
+        if (!(e instanceof SinceError))
+            throw e;
+        trackChildFromEnv()?.note(e.message); // a backfill child records why it ended
+        console.error(chalk.red(`align connect: ${e.message}`));
+        return process.exit(2);
+    }
+}
+//# sourceMappingURL=since-flag.js.map

package/dist/lib/since-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"since-flag.js","sourceRoot":"","sources":["../../src/lib/since-flag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAC;AAErE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,0FAA0F,CAAC;AAErH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAuB,EAAE,MAAY,IAAI,IAAI,EAAE;IAC3E,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC;YAAE,MAAM,CAAC,CAAC;QACxC,iBAAiB,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wCAAwC;QAC9E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/lib/since.d.ts

@@ -0,0 +1,59 @@
+/**
+ * L3: the ONE parser for how far back an import reads. `align connect --since` and the MCP
+ * tool `align_backfill` both call it, so the two surfaces cannot accept different spellings
+ * of the same window (code-style.md: two readers of one format must agree).
+ *
+ * Accepted: `Nd`, `Nw`, `Nm` (a month is 30.4 days, rounded), `Ny`, and `all`. Anything else
+ * is a SinceError: a window the user did not mean is worse than a refusal, because the
+ * report would still say the read was complete.
+ */
+import { type SourceId } from './import-defaults.js';
+import type { ScopeFetchOpts } from './scope-values.js';
+export declare const ACCEPTED_SINCE_FORMS = "30d, 2w, 6m, 1y or all";
+export declare class SinceError extends Error {
+    constructor(raw: string, why: string);
+}
+export interface SyncWindow {
+    /** Days back from now. Absent for `all`. */
+    days?: number;
+    /** ISO-8601 UTC lower bound for the SDK's `since`. Absent for `all`: only the ceiling applies. */
+    since?: string;
+}
+/** `undefined` means the flag was not passed: the plan default applies. */
+export declare function parseSince(raw: string | undefined, now?: Date): SyncWindow;
+/**
+ * The phrase the capture report prints. Exact: "the last 6 months" only for a window that IS
+ * what `6m` parses to (182 days). The default is 180 days and reads "the last 180 days", so two
+ * different reads never share a label. A month or year label needs the day count to be exactly
+ * what that many months or years parse to; anything else is said in days.
+ */
+export declare function windowLabel(days: number | undefined): string;
+/**
+ * The options every windowed fetch gets: this source's ceiling, the shared time budget and the
+ * window's lower bound. `since` is OMITTED for `all`, never set to undefined, so the SDK sees no
+ * bound at all. The one reader of SYNC_CEILINGS for a fetch (import-defaults.test.ts pins it).
+ */
+export declare function fetchWindow(id: SourceId, window: SyncWindow): {
+    limit: number;
+    timeBudgetMs: number;
+    since?: string;
+};
+/**
+ * What a source's fetch is handed beyond the window: L5's `until` and Slack `hotThreads`, and L4's team-scope option (Jira `projects`,
+ * Linear `teams`, GitLab `projectId`, Confluence `spaces`). `team` and `repo` are GitHub's, read by its closure in setup.ts.
+ */
+export interface FetchExtras extends ScopeFetchOpts {
+    until?: string;
+    hotThreads?: Array<{
+        channel: string;
+        ts: string;
+    }>;
+    team?: boolean;
+    /** GitHub team scope: the repo. */
+    repo?: string;
+    /** True when the caller has already decided the scope (repo or none): the fetch must not look at the folder itself. */
+    resolved?: boolean;
+}
+/** The optional extras a fetch adds to the window itself. Omitted keys stay omitted. */
+export declare function windowExtras(o?: FetchExtras): FetchExtras;
+//# sourceMappingURL=since.d.ts.map

package/dist/lib/since.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"since.d.ts","sourceRoot":"","sources":["../../src/lib/since.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAgE,MAAM,sBAAsB,CAAC;AACnH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAS7D,qBAAa,UAAW,SAAQ,KAAK;gBACvB,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKrC;AAED,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,IAAiB,GAAG,UAAU,CAUtF;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ5D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAMrH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uHAAuH;IACvH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,CASzD"}

package/dist/lib/since.js

@@ -0,0 +1,86 @@
+/**
+ * L3: the ONE parser for how far back an import reads. `align connect --since` and the MCP
+ * tool `align_backfill` both call it, so the two surfaces cannot accept different spellings
+ * of the same window (code-style.md: two readers of one format must agree).
+ *
+ * Accepted: `Nd`, `Nw`, `Nm` (a month is 30.4 days, rounded), `Ny`, and `all`. Anything else
+ * is a SinceError: a window the user did not mean is worse than a refusal, because the
+ * report would still say the read was complete.
+ */
+import { SYNC_CEILINGS, SYNC_TIME_BUDGET_MS, SYNC_WINDOW_DEFAULT_DAYS } from './import-defaults.js';
+export const ACCEPTED_SINCE_FORMS = '30d, 2w, 6m, 1y or all';
+const DAY_MS = 86_400_000;
+const MONTH_DAYS = 30.4;
+const DAYS_PER_UNIT = { d: 1, w: 7, m: MONTH_DAYS, y: 365 };
+// The SDK refuses a window that starts before 1970 (a `shape` skip, nothing read). Refusing
+// it here turns that into a message naming the accepted forms instead of a skip line.
+const EPOCH_MS = Date.UTC(1970, 0, 1);
+export class SinceError extends Error {
+    constructor(raw, why) {
+        // Cut: a pasted secret in the wrong field must not ride along into an error transcript.
+        super(`Cannot read "${raw.slice(0, 16)}" as how far back to look: ${why}. Use ${ACCEPTED_SINCE_FORMS}.`);
+        this.name = 'SinceError';
+    }
+}
+/** `undefined` means the flag was not passed: the plan default applies. */
+export function parseSince(raw, now = new Date()) {
+    if (raw === undefined)
+        return windowOfDays(SYNC_WINDOW_DEFAULT_DAYS, now);
+    const text = raw.trim().toLowerCase();
+    if (text === 'all')
+        return {};
+    const m = /^(\d+)([dwmy])$/.exec(text);
+    if (!m)
+        throw new SinceError(raw, 'it is not a whole number followed by d, w, m or y');
+    const days = Math.round(Number(m[1]) * DAYS_PER_UNIT[m[2]]);
+    if (days < 1)
+        throw new SinceError(raw, 'it is not a positive length of time');
+    if (now.getTime() - days * DAY_MS < EPOCH_MS)
+        throw new SinceError(raw, 'it reaches back before 1970');
+    return windowOfDays(days, now);
+}
+function windowOfDays(days, now) {
+    return { days, since: new Date(now.getTime() - days * DAY_MS).toISOString() };
+}
+/**
+ * The phrase the capture report prints. Exact: "the last 6 months" only for a window that IS
+ * what `6m` parses to (182 days). The default is 180 days and reads "the last 180 days", so two
+ * different reads never share a label. A month or year label needs the day count to be exactly
+ * what that many months or years parse to; anything else is said in days.
+ */
+export function windowLabel(days) {
+    if (days === undefined)
+        return 'all the history the ceiling allowed';
+    const plural = (n, unit) => `${n} ${unit}${n === 1 ? '' : 's'}`;
+    // Years first: 3y is 1095 days, which 36 months (1094) does not round-trip to.
+    if (days % 365 === 0)
+        return `the last ${plural(days / 365, 'year')}`;
+    const months = Math.round(days / MONTH_DAYS);
+    if (months >= 2 && Math.round(months * MONTH_DAYS) === days)
+        return `the last ${plural(months, 'month')}`;
+    return `the last ${plural(days, 'day')}`;
+}
+/**
+ * The options every windowed fetch gets: this source's ceiling, the shared time budget and the
+ * window's lower bound. `since` is OMITTED for `all`, never set to undefined, so the SDK sees no
+ * bound at all. The one reader of SYNC_CEILINGS for a fetch (import-defaults.test.ts pins it).
+ */
+export function fetchWindow(id, window) {
+    return {
+        limit: SYNC_CEILINGS[id],
+        timeBudgetMs: SYNC_TIME_BUDGET_MS,
+        ...(window.since !== undefined ? { since: window.since } : {}),
+    };
+}
+/** The optional extras a fetch adds to the window itself. Omitted keys stay omitted. */
+export function windowExtras(o) {
+    return {
+        ...(o?.until !== undefined ? { until: o.until } : {}),
+        ...(o?.hotThreads !== undefined && o.hotThreads.length > 0 ? { hotThreads: o.hotThreads } : {}),
+        ...(o?.projects !== undefined ? { projects: o.projects } : {}),
+        ...(o?.teams !== undefined ? { teams: o.teams } : {}),
+        ...(o?.projectId !== undefined ? { projectId: o.projectId } : {}),
+        ...(o?.spaces !== undefined ? { spaces: o.spaces } : {}),
+    };
+}
+//# sourceMappingURL=since.js.map

package/dist/lib/since.js.map

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

package/dist/lib/source-key.d.ts

@@ -0,0 +1,13 @@
+export { normaliseSourceKey } from '@aligndottech/connector-core';
+/** Every platform a connector import can key. */
+export declare const KEYED_PLATFORMS: readonly string[];
+/**
+ * The key stored in `decisions.source_key`, or undefined (the row keeps its
+ * (source_url, title) identity). The platform is part of the stored string, so a `git` import
+ * and a `github` row for the same commit URL are different items and never merge.
+ *
+ * Only a connector import is ever given one (callers decide that; see insertDecision's
+ * `keyed`). The platform alone cannot say: `align capture <PR url>` also stamps `github`.
+ */
+export declare function connectorItemKey(platform: string, url: string | null | undefined): string | undefined;
+//# sourceMappingURL=source-key.d.ts.map

package/dist/lib/source-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-key.d.ts","sourceRoot":"","sources":["../../src/lib/source-key.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAkBlE,iDAAiD;AACjD,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAA6B,CAAC;AAE3E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUrG"}

package/dist/lib/source-key.js

@@ -0,0 +1,60 @@
+/**
+ * The identity of a connector item that is exactly one thing per URL - a PR, an issue, an MR, a
+ * page, a Slack or Teams thread, a Zoom recording, a git commit. Two rows with the same key are
+ * one item whose title was edited, which the (source_url, title) key cannot see.
+ *
+ * L3: `normaliseSourceKey` is connector-core's own function, re-exported. Until connector-core
+ * 0.10.0 this file held a behavioural copy; one function now decides the key here, in the hosted
+ * scan and at share time. src/__tests__/source-key.test.ts runs the SDK's published fixture table
+ * (its `./source-key-fixtures.json` export) against it and asserts it is the same function.
+ *
+ * `connectorItemKey` below is local policy, not part of the shared format: which rows may be
+ * keyed at all.
+ */
+import { normaliseSourceKey } from '@aligndottech/connector-core';
+export { normaliseSourceKey } from '@aligndottech/connector-core';
+/** Per platform: the path shapes that address ONE item. The SDK function keys any URL that is
+ *  not a bare host; this gate stays on top of it so an unrecognised shape (a fetcher fallback
+ *  that names a site or a listing) costs a possible twin, never a wrong merge. Local policy. */
+const ITEM_SHAPES = {
+    github: [/^\/[^/]+\/[^/]+\/(pull|issues|commit)\/[^/]+$/],
+    gitlab: [/^\/.+\/-\/(merge_requests|issues|commit)\/[^/]+$/],
+    jira: [/\/browse\/[A-Za-z][A-Za-z0-9_]*-\d+$/],
+    linear: [/\/issue\/[A-Za-z0-9]+-\d+(\/[^/]*)?$/],
+    confluence: [/\/pages\/\d+(\/[^/]*)?$/, /\/pages\/viewpage\.action$/],
+    notion: [/[0-9a-f]{32}$/i],
+    slack: [/^\/archives\/[A-Za-z0-9]+\/p\d+$/],
+    teams: [/^\/l\/message\/[^/]+\/\d+$/],
+    zoom: [/^\/recording\/[^/]+$/],
+    git: [/\/commit\/[0-9a-f]{7,40}$/i, /^\/\/commit\/[0-9a-f]{7,40}$/i],
+};
+/** Every platform a connector import can key. */
+export const KEYED_PLATFORMS = Object.keys(ITEM_SHAPES);
+/**
+ * The key stored in `decisions.source_key`, or undefined (the row keeps its
+ * (source_url, title) identity). The platform is part of the stored string, so a `git` import
+ * and a `github` row for the same commit URL are different items and never merge.
+ *
+ * Only a connector import is ever given one (callers decide that; see insertDecision's
+ * `keyed`). The platform alone cannot say: `align capture <PR url>` also stamps `github`.
+ */
+export function connectorItemKey(platform, url) {
+    const shapes = ITEM_SHAPES[platform];
+    if (!shapes || !url)
+        return undefined;
+    const key = normaliseSourceKey(platform, url);
+    if (key === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(key);
+    }
+    catch {
+        return undefined;
+    }
+    const path = parsed.protocol === 'git:' ? `//${parsed.host}${parsed.pathname}` : parsed.pathname;
+    if (!shapes.some(p => p.test(path)))
+        return undefined;
+    return `${platform}|${key}`;
+}
+//# sourceMappingURL=source-key.js.map

package/dist/lib/source-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-key.js","sourceRoot":"","sources":["../../src/lib/source-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE;;gGAEgG;AAChG,MAAM,WAAW,GAA6B;IAC5C,MAAM,EAAE,CAAC,+CAA+C,CAAC;IACzD,MAAM,EAAE,CAAC,kDAAkD,CAAC;IAC5D,IAAI,EAAE,CAAC,sCAAsC,CAAC;IAC9C,MAAM,EAAE,CAAC,sCAAsC,CAAC;IAChD,UAAU,EAAE,CAAC,yBAAyB,EAAE,4BAA4B,CAAC;IACrE,MAAM,EAAE,CAAC,gBAAgB,CAAC;IAC1B,KAAK,EAAE,CAAC,kCAAkC,CAAC;IAC3C,KAAK,EAAE,CAAC,4BAA4B,CAAC;IACrC,IAAI,EAAE,CAAC,sBAAsB,CAAC;IAC9B,GAAG,EAAE,CAAC,4BAA4B,EAAE,+BAA+B,CAAC;CACrE,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAsB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,GAA8B;IAC/E,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QAAC,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACjG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,OAAO,GAAG,QAAQ,IAAI,GAAG,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,12 @@
+/** The scope this phase writes under: the caller's own items. L4 adds repo/project/space keys
+ *  ('repo:o/r', 'jira:ALI', ...) when scope pickers land, and L5's nextWindow reads whichever
+ *  row is in force. */
+export declare const WINDOW_SCOPE_KEY = "yours";
+/** `needsReauth` is true when ANY scope row of the source says so: a token the vendor refused
+ *  is refused for the whole source. Absence of a row is no problem, not a pass. */
+export declare function readSyncStatus(dbPath: string, sourceId: string): {
+    needsReauth: boolean;
+};
+/** Record the window the user asked for. `null` is `all`: no lower bound, only the ceiling. */
+export declare function recordWindowSince(dbPath: string, sourceId: string, windowSince: string | null, changedByAgent: string): void;
+//# sourceMappingURL=source-sync-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-sync-state.d.ts","sourceRoot":"","sources":["../../src/lib/source-sync-state.ts"],"names":[],"mappings":"AAYA;;uBAEuB;AACvB,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAYxC;mFACmF;AACnF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAKzF;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAS5H"}

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

@@ -0,0 +1,43 @@
+/**
+ * L3: the slice of `source_sync` (schema v7) that `align_backfill` needs before L5's sync
+ * exists: is this source waiting on the user to re-authenticate, and what window did the user
+ * ask for. L5 owns the watermark columns (high_water, pending_until, last_*, items_last_run);
+ * nothing here writes them, and an upsert here never clears one.
+ *
+ * Opens its own short-lived handle on purpose. The MCP server holds the graph open through the
+ * local gateway client; this is a one-row read or write, and WAL plus the 30 s busy_timeout
+ * (set below, as local-db.ts sets it) is the case that pairing exists for.
+ */
+import { DatabaseSync } from 'node:sqlite';
+/** The scope this phase writes under: the caller's own items. L4 adds repo/project/space keys
+ *  ('repo:o/r', 'jira:ALI', ...) when scope pickers land, and L5's nextWindow reads whichever
+ *  row is in force. */
+export const WINDOW_SCOPE_KEY = 'yours';
+function withDb(dbPath, fn) {
+    const db = new DatabaseSync(dbPath);
+    try {
+        db.exec('PRAGMA busy_timeout = 30000');
+        return fn(db);
+    }
+    finally {
+        db.close();
+    }
+}
+/** `needsReauth` is true when ANY scope row of the source says so: a token the vendor refused
+ *  is refused for the whole source. Absence of a row is no problem, not a pass. */
+export function readSyncStatus(dbPath, sourceId) {
+    return withDb(dbPath, (db) => {
+        const row = db.prepare(`SELECT 1 AS hit FROM source_sync WHERE source_id = ? AND status = 'needs_reauth' LIMIT 1`).get(sourceId);
+        return { needsReauth: row !== undefined };
+    });
+}
+/** Record the window the user asked for. `null` is `all`: no lower bound, only the ceiling. */
+export function recordWindowSince(dbPath, sourceId, windowSince, changedByAgent) {
+    withDb(dbPath, (db) => {
+        db.prepare(`INSERT INTO source_sync (source_id, scope_key, scope, window_since, changed_via, changed_by_agent)
+       VALUES (?, ?, 'yours', ?, 'mcp', ?)
+       ON CONFLICT(source_id, scope_key) DO UPDATE SET
+         window_since = excluded.window_since, changed_via = 'mcp', changed_by_agent = excluded.changed_by_agent`).run(sourceId, WINDOW_SCOPE_KEY, windowSince, changedByAgent);
+    });
+}
+//# sourceMappingURL=source-sync-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-sync-state.js","sourceRoot":"","sources":["../../src/lib/source-sync-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;uBAEuB;AACvB,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,SAAS,MAAM,CAAI,MAAc,EAAE,EAA2B;IAC5D,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED;mFACmF;AACnF,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB;IAC7D,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,0FAA0F,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjI,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,QAAgB,EAAE,WAA0B,EAAE,cAAsB;IACpH,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;QACpB,EAAE,CAAC,OAAO,CACR;;;iHAG2G,CAC5G,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/startup-backfill-track.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=startup-backfill-track.d.ts.map

package/dist/lib/startup-backfill-track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-backfill-track.d.ts","sourceRoot":"","sources":["../../src/lib/startup-backfill-track.ts"],"names":[],"mappings":""}

package/dist/lib/startup-backfill-track.js

@@ -0,0 +1,6 @@
+import { trackChildFromEnv } from './backfill-state.js';
+// THIRD, right after startup-xdg: when `align_backfill` started this process, record from the first
+// moment how it ends. Anything later (a bad --since, a commander parse error, an uncaught error)
+// exits through process.exit, which the exit handler turns into a final "failed" status.
+trackChildFromEnv();
+//# sourceMappingURL=startup-backfill-track.js.map

package/dist/lib/startup-backfill-track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-backfill-track.js","sourceRoot":"","sources":["../../src/lib/startup-backfill-track.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,oGAAoG;AACpG,iGAAiG;AACjG,yFAAyF;AACzF,iBAAiB,EAAE,CAAC"}

package/dist/lib/startup-env.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The environment as the user's shell handed it to align, captured before any align module
+ * runs (index.ts imports this first). The launcher restores every LLM provider variable to
+ * this snapshot before starting a coding agent, so a key align put into its own environment
+ * can never reach the agent, while a key the user exported always does.
+ */
+export declare const STARTUP_ENV: Readonly<Record<string, string | undefined>>;
+//# sourceMappingURL=startup-env.d.ts.map

package/dist/lib/startup-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-env.d.ts","sourceRoot":"","sources":["../../src/lib/startup-env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAqC,CAAC"}

package/dist/lib/startup-env.js

@@ -0,0 +1,8 @@
+/**
+ * The environment as the user's shell handed it to align, captured before any align module
+ * runs (index.ts imports this first). The launcher restores every LLM provider variable to
+ * this snapshot before starting a coding agent, so a key align put into its own environment
+ * can never reach the agent, while a key the user exported always does.
+ */
+export const STARTUP_ENV = Object.freeze({ ...process.env });
+//# sourceMappingURL=startup-env.js.map

package/dist/lib/startup-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-env.js","sourceRoot":"","sources":["../../src/lib/startup-env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiD,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/lib/startup-xdg.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=startup-xdg.d.ts.map

package/dist/lib/startup-xdg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-xdg.d.ts","sourceRoot":"","sources":["../../src/lib/startup-xdg.ts"],"names":[],"mappings":""}

package/dist/lib/startup-xdg.js

@@ -0,0 +1,9 @@
+import { dropRelativeXdg } from './xdg.js';
+/*
+ * Imported second by index.ts, right after the startup-env snapshot and before any module that
+ * computes a directory (`conf`, env-paths, local-mode): a relative XDG_* is invalid per the XDG
+ * spec, and in the MCP child of an agent that loads a repo `.env` it would point align's config,
+ * cache and local.db into that repo.
+ */
+dropRelativeXdg(process.env);
+//# sourceMappingURL=startup-xdg.js.map

package/dist/lib/startup-xdg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-xdg.js","sourceRoot":"","sources":["../../src/lib/startup-xdg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;GAKG;AACH,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC"}

package/dist/lib/sync/after-connect.d.ts

@@ -0,0 +1,2 @@
+export declare function afterSourceConnected(dbPath: string | undefined, source: string, isConnected: (id: string) => boolean): void;
+//# sourceMappingURL=after-connect.d.ts.map

package/dist/lib/sync/after-connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-connect.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/after-connect.ts"],"names":[],"mappings":"AASA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAM3H"}

package/dist/lib/sync/after-connect.js

@@ -0,0 +1,18 @@
+/**
+ * L5: a fresh token was saved for a source (a foreground `align connect`/`setup` that read it
+ * successfully). The source is no longer waiting on the person, and the launch summary now lists
+ * it. Best effort and silent: a connect must never fail because a cache could not be written.
+ */
+import fs from 'node:fs';
+import { clearNeedsReauth } from './sync-state.js';
+import { refreshSummary } from './summary.js';
+export function afterSourceConnected(dbPath, source, isConnected) {
+    if (dbPath === undefined || !fs.existsSync(dbPath))
+        return;
+    try {
+        clearNeedsReauth(dbPath, source);
+        refreshSummary(dbPath, isConnected);
+    }
+    catch { /* the next sync rebuilds both */ }
+}
+//# sourceMappingURL=after-connect.js.map

package/dist/lib/sync/after-connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-connect.js","sourceRoot":"","sources":["../../../src/lib/sync/after-connect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,UAAU,oBAAoB,CAAC,MAA0B,EAAE,MAAc,EAAE,WAAoC;IACnH,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAC3D,IAAI,CAAC;QACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC,CAAC,iCAAiC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/sync/bg-claim.d.ts

@@ -0,0 +1,14 @@
+export declare const claimFile: (dir: string, source: string, bucket: number) => string;
+/** Is a claim for this source in force (this bucket's or the previous one's)? Reads only. */
+export declare function claimInForce(dir: string, source: string, now: number, intervalMs: number): boolean;
+export type ClaimResult = {
+    ok: true;
+} | {
+    ok: false;
+    why: 'held' | 'unwritable';
+};
+export declare function takeClaim(dir: string, source: string, now: number, intervalMs: number): ClaimResult;
+export declare function releaseClaim(dir: string, source: string, now: number, intervalMs: number): void;
+/** Why a background refresh cannot record its claim for this source (a directory or other object in the way, or an unwritable state directory), or undefined. For `align sync --status`. */
+export declare function claimProblem(dir: string, source: string, now: number, intervalMs: number): string | undefined;
+//# sourceMappingURL=bg-claim.d.ts.map

package/dist/lib/sync/bg-claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bg-claim.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/bg-claim.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,KAAG,MAAuD,CAAC;AAehI,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAGlG;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEnF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAmBnG;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAE/F;AAYD,4LAA4L;AAC5L,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW7G"}