@aligndottech/cli 0.49.0 → 0.51.0

package/dist/lib/mcp-scope.d.ts

@@ -0,0 +1,90 @@
+/**
+ * L4: the MCP tool `align_scope({ action, source, ... })` - see, or change, what the sources the user already connected read.
+ *
+ * What it does, and what it cannot:
+ * - `view`: each connected source's scope (their own items, or everyone's in a named repo, project, team or space), with no network
+ *   call and nothing secret.
+ * - `set`: changes the scope of a CONNECTED source through `setScope`, the same function `align connect --scope` ends in, so a
+ *   change by an agent takes exactly the path a person's does. It records `via = 'mcp'` and the agent id on the scope's row, returns
+ *   the plain-words disclosure and what widening costs (a new scope re-reads the window), and never deletes an item.
+ * - Listing choices (is this Jira project visible?) uses the saved token inside this process. The token never appears in a result.
+ * - Connecting, re-authenticating and every token or key stay with the person: the input schema is closed, so a `token` or `api_key`
+ *   property is refused before anything runs, and the reply for an unconnected source is the `align connect <source>` command.
+ * - Zoom is only the user's own and says why. Slack, Notion and Teams already read all the token can see and have nothing to set.
+ *
+ * The server's `instructions` text is at its 2,048-byte budget, so the guidance for when to offer this tool lives here, in its description.
+ */
+import type { EnvironmentConfig } from './config.js';
+import { type ScopeDeps } from './scope.js';
+export declare const SCOPE_TOOL = "align_scope";
+export declare const SCOPE_ACTIONS: readonly ["view", "set"];
+/** Every source that can be connected, so Zoom gets its own honest refusal instead of "unknown source". */
+export declare const SCOPE_SOURCES: readonly ["github", "jira", "confluence", "slack", "teams", "gitlab", "linear", "notion", "zoom"];
+export declare const SCOPE_TOOL_SCHEMA: {
+    readonly name: "align_scope";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+    };
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["view", "set"];
+                readonly description: "view: show the scopes. set: change one source's scope";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["github", "jira", "confluence", "slack", "teams", "gitlab", "linear", "notion", "zoom"];
+                readonly description: "With \"set\": which connected source to change";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly enum: readonly ["yours", "team"];
+                readonly description: "With \"set\": \"yours\" goes back to only the user's own items. \"team\" is implied by passing the source's value below";
+            };
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "GitHub: the repo as owner/repo";
+            };
+            readonly projects: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Jira: project keys, for example [\"ALI\",\"OPS\"]";
+            };
+            readonly teams: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Linear: team keys, for example [\"ENG\"]";
+            };
+            readonly gitlab_project: {
+                readonly type: "string";
+                readonly description: "GitLab: the project id or group/project path";
+            };
+            readonly spaces: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Confluence: space keys, for example [\"ENG\"]";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+};
+export interface ScopeToolResult {
+    text: string;
+    [k: string]: unknown;
+}
+export declare function defaultScopeToolDeps(env: EnvironmentConfig): ScopeDeps;
+export declare function runScopeTool(args: Record<string, unknown> | undefined, env: EnvironmentConfig, injected?: ScopeDeps, o?: {
+    agent?: string;
+}): Promise<ScopeToolResult>;
+//# sourceMappingURL=mcp-scope.d.ts.map

package/dist/lib/mcp-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-scope.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,SAAS,EAAqD,MAAM,YAAY,CAAC;AAK/F,eAAO,MAAM,UAAU,gBAAgB,CAAC;AACxC,eAAO,MAAM,aAAa,0BAA2B,CAAC;AACtD,2GAA2G;AAC3G,eAAO,MAAM,aAAa,mGAAoG,CAAC;AAM/H,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BpB,CAAC;AAEX,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;AAIvE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,CAItE;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,GAAG,EAAE,iBAAiB,EACtB,QAAQ,CAAC,EAAE,SAAS,EACpB,CAAC,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACzB,OAAO,CAAC,eAAe,CAAC,CAoB1B"}

package/dist/lib/mcp-scope.js

@@ -0,0 +1,125 @@
+import { ScopeRefusal, setScope, viewScopes } from './scope.js';
+import { UNKNOWN_AGENT } from './mcp/tool-rules.js';
+import { realScopeDeps } from './scope-real.js';
+import { SCOPED_SOURCES } from './scope-values.js';
+export const SCOPE_TOOL = 'align_scope';
+export const SCOPE_ACTIONS = ['view', 'set'];
+/** Every source that can be connected, so Zoom gets its own honest refusal instead of "unknown source". */
+export const SCOPE_SOURCES = ['github', 'jira', 'confluence', 'slack', 'teams', 'gitlab', 'linear', 'notion', 'zoom'];
+/** The one value property each source takes for a team scope. */
+const VALUE_PROPERTY = { github: 'repo', jira: 'projects', linear: 'teams', gitlab: 'gitlab_project', confluence: 'spaces' };
+const VALUE_PROPERTIES = Object.values(VALUE_PROPERTY);
+export const SCOPE_TOOL_SCHEMA = {
+    name: SCOPE_TOOL,
+    annotations: { readOnlyHint: false, destructiveHint: false },
+    description: 'See, or change, what the sources the user has ALREADY connected read into the local graph on this machine: only their own items, or everyone\'s in one named GitHub repo, Jira project, Linear team, GitLab project or Confluence space that their token can see. ' +
+        'action "view" lists each connected source\'s scope (and any change waiting for the person); use it when asked what is read or why teammates\' items are missing. ' +
+        'action "set" changes one source; offer it when the user asks to include their team\'s items, or to go back to only their own. ' +
+        'Widening re-reads that source\'s history on its next sync (a few minutes; the reply says how far back). ' +
+        'It deletes nothing and reads other people\'s items onto this machine only. A team change you make WAITS: nothing reads it, in the background or via align_sync, until a person runs `align sync <source>` at a terminal, which shows what it reads and asks (default No). Tell them so, with the reply\'s disclosure sentence in your own words. That prompt is a speed bump, not proof of consent: an agent with shell access could answer it from a pseudo-terminal, and you must never do that. Narrowing to their own items is immediate. ' +
+        'Zoom is only the user\'s own; Slack, Notion and Teams already read all their token can see. ' +
+        'It never takes a token or key: for a source that is not connected, or whose saved token was refused, the reply gives the exact `align connect <source>` command for the user to run themselves. Do not ask the user to paste a token into the chat.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: { type: 'string', enum: [...SCOPE_ACTIONS], description: 'view: show the scopes. set: change one source\'s scope' },
+            source: { type: 'string', enum: [...SCOPE_SOURCES], description: 'With "set": which connected source to change' },
+            scope: { type: 'string', enum: ['yours', 'team'], description: 'With "set": "yours" goes back to only the user\'s own items. "team" is implied by passing the source\'s value below' },
+            repo: { type: 'string', description: 'GitHub: the repo as owner/repo' },
+            projects: { type: 'array', items: { type: 'string' }, description: 'Jira: project keys, for example ["ALI","OPS"]' },
+            teams: { type: 'array', items: { type: 'string' }, description: 'Linear: team keys, for example ["ENG"]' },
+            gitlab_project: { type: 'string', description: 'GitLab: the project id or group/project path' },
+            spaces: { type: 'array', items: { type: 'string' }, description: 'Confluence: space keys, for example ["ENG"]' },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+const KNOWN = new Set(Object.keys(SCOPE_TOOL_SCHEMA.inputSchema.properties));
+export function defaultScopeToolDeps(env) {
+    const dbPath = env.localDbPath;
+    if (!dbPath)
+        throw new Error(`${SCOPE_TOOL} needs the local graph path, and this server has none configured.`);
+    return realScopeDeps(dbPath);
+}
+export async function runScopeTool(args, env, injected, o = {}) {
+    const input = args ?? {};
+    const unknownKeys = Object.keys(input).filter((k) => !KNOWN.has(k));
+    if (unknownKeys.length) {
+        // Neither the values NOR the key names: a token pasted as a property name must not be echoed into the transcript it was typed into.
+        throw new Error(`${SCOPE_TOOL} does not accept ${unknownKeys.length === 1 ? 'an unknown property' : `${unknownKeys.length} unknown properties`} (the name is not printed back). It never accepts a token or key: the person connects a source themselves with \`align connect <source>\`.`);
+    }
+    const action = input['action'];
+    if (action !== 'view' && action !== 'set')
+        throw new Error(`${SCOPE_TOOL} requires "action", one of: ${SCOPE_ACTIONS.join(', ')}. Call it again with one of those.`);
+    if (env.mode !== 'local-embedded') {
+        throw new Error(`${SCOPE_TOOL} edits what the local graph on this machine reads, and this server reads a hosted Align graph. ` +
+            'Use the local Align server (align mcp --env local); a hosted graph reads what its connectors are set up to read.');
+    }
+    const deps = injected ?? defaultScopeToolDeps(env);
+    if (action === 'view')
+        return view(deps);
+    return set(input, deps, o.agent ?? UNKNOWN_AGENT);
+}
+async function view(deps) {
+    const sources = await viewScopes(deps);
+    if (sources.length === 0) {
+        return { text: 'No source is connected, so there is no scope to show. Connecting needs a token only the person can supply. Ask them to run: align connect <source>', sources: [] };
+    }
+    const name = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+    const lines = sources.map((s) => `${name(s.source)}: ${s.label}${s.origin === 'detected' ? " (from this folder's git remote)" : ''}.`);
+    return { text: lines.join('\n'), sources };
+}
+/** The schema says which are lists (projects, teams, spaces) and which are one text value (repo, gitlab_project): hold the input to it. */
+function valueOf(property, v) {
+    const one = property === 'repo' || property === 'gitlab_project';
+    if (one && typeof v === 'string')
+        return v;
+    if (!one && Array.isArray(v) && v.every((x) => typeof x === 'string'))
+        return v;
+    throw new Error(`${SCOPE_TOOL} "${property}" must be ${one ? 'one text value' : 'a list of text values'}.`);
+}
+async function set(input, deps, agent) {
+    const source = input['source'];
+    if (source === undefined)
+        throw new Error(`${SCOPE_TOOL} requires "source" with action "set", one of: ${SCOPE_SOURCES.join(', ')}.`);
+    if (typeof source !== 'string' || !SCOPE_SOURCES.includes(source)) {
+        throw new Error(`${SCOPE_TOOL} "source" must be one of: ${SCOPE_SOURCES.join(', ')}.`);
+    }
+    const scope = input['scope'];
+    if (scope !== undefined && scope !== 'yours' && scope !== 'team')
+        throw new Error(`${SCOPE_TOOL} "scope" must be "yours" or "team".`);
+    const wanted = SCOPED_SOURCES.includes(source) ? VALUE_PROPERTY[source] : undefined;
+    const given = VALUE_PROPERTIES.filter((p) => input[p] !== undefined);
+    const wrong = given.filter((p) => p !== wanted);
+    if (wanted !== undefined && wrong.length > 0)
+        throw new Error(`${SCOPE_TOOL} for ${source} takes "${wanted}", not "${wrong[0]}".`);
+    let change;
+    if (scope === 'yours') {
+        if (given.length > 0)
+            throw new Error(`${SCOPE_TOOL} takes either scope "yours" or a value to read, not both.`);
+        change = { scope: 'yours' };
+    }
+    else if (wanted === undefined) {
+        // Zoom, Slack, Notion, Teams: setScope refuses with the honest reason for that source.
+        change = { scope: 'team', values: [] };
+    }
+    else {
+        if (input[wanted] === undefined)
+            throw new Error(`${SCOPE_TOOL} for ${source} needs "${wanted}" to name what to read, or scope "yours" to go back to the user's own items.`);
+        change = { scope: 'team', values: valueOf(wanted, input[wanted]) };
+    }
+    try {
+        const r = await setScope(deps, source, change, { via: 'mcp', agent });
+        return {
+            text: [r.text, r.disclosure].filter((x) => x !== undefined && x !== '').join(' '),
+            source: r.source, scope: r.scope, scope_key: r.scopeKey, new_scope: r.newRow, pending: r.pending === true,
+        };
+    }
+    catch (e) {
+        if (e instanceof ScopeRefusal)
+            throw new Error(e.message);
+        throw e;
+    }
+}
+//# sourceMappingURL=mcp-scope.js.map

package/dist/lib/mcp-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-scope.js","sourceRoot":"","sources":["../../src/lib/mcp-scope.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,YAAY,EAAiB,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC;AACtD,2GAA2G;AAC3G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAE/H,iEAAiE;AACjE,MAAM,cAAc,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAW,CAAC;AACtI,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;IAC5D,WAAW,EACT,oQAAoQ;QACpQ,mKAAmK;QACnK,gIAAgI;QAChI,0GAA0G;QAC1G,ghBAAghB;QAChhB,8FAA8F;QAC9F,qPAAqP;IACvP,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,WAAW,EAAE,wDAAwD,EAAE;YAC3H,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,WAAW,EAAE,8CAA8C,EAAE;YACjH,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,qHAAqH,EAAE;YACtL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACvE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,+CAA+C,EAAE;YACpH,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,wCAAwC,EAAE;YAC1G,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;YAC/F,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,6CAA6C,EAAE;SACjH;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,oBAAoB,EAAE,KAAK;KAC5B;CACO,CAAC;AAIX,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;AAE7E,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,mEAAmE,CAAC,CAAC;IAC/G,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAyC,EACzC,GAAsB,EACtB,QAAoB,EACpB,IAAwB,EAAE;IAE1B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IACzB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,oIAAoI;QACpI,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,oBAAoB,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,qBAAqB,4IAA4I,CAC3Q,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,+BAA+B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACrK,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,iGAAiG;YAC9G,kHAAkH,CACnH,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAe;IACjC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,oJAAoJ,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrL,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvI,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,2IAA2I;AAC3I,SAAS,OAAO,CAAC,QAAgB,EAAE,CAAU;IAC3C,MAAM,GAAG,GAAG,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,gBAAgB,CAAC;IACjE,IAAI,GAAG,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QAAE,OAAO,CAAa,CAAC;IAC5F,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,KAAK,QAAQ,aAAa,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,uBAAuB,GAAG,CAAC,CAAC;AAC9G,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,KAA8B,EAAE,IAAe,EAAE,KAAa;IAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,iDAAiD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,6BAA6B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,qCAAqC,CAAC,CAAC;IAEtI,MAAM,MAAM,GAAI,cAAoC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAqC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1I,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAChD,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,QAAQ,MAAM,WAAW,MAAM,WAAW,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEnI,IAAI,MAAgB,CAAC;IACrB,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,2DAA2D,CAAC,CAAC;QAChH,MAAM,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;SAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,uFAAuF;QACvF,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,QAAQ,MAAM,WAAW,MAAM,8EAA8E,CAAC,CAAC;QAC7K,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACtE,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACjF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,KAAK,IAAI;SAC1G,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,64 @@
+import type { EnvironmentConfig } from './config.js';
+import { estimateClassify } from './sync/classify.js';
+import { type StatusDeps } from './sync/status.js';
+export declare const SYNC_TOOL = "align_sync";
+export declare const SYNC_ACTIONS: readonly ["status", "run", "classify_estimate"];
+export declare const SYNC_TOOL_SCHEMA: {
+    readonly name: "align_sync";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+    };
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["status", "run", "classify_estimate"];
+                readonly description: "What to do";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["github", "jira", "confluence", "slack", "teams", "gitlab", "linear", "notion"];
+                readonly description: "With \"run\": only this source. Default: every connected source";
+            };
+            readonly max: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 1000;
+                readonly description: "With \"classify_estimate\": how many items the person would classify (default 25)";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+};
+export interface SyncToolDeps {
+    dbPath: string;
+    status: StatusDeps;
+    needsReauth(source: string): boolean;
+    syncRunning(source: string): boolean;
+    backfillRunning(source: string): boolean;
+    /** Take a slot per source SYNCHRONOUSLY, before the child exists (MCP does not queue calls, so parallel `run`s would all pass
+     *  the lock check and start a child each). All or none: a refusal names the sources that are taken. */
+    reserve?(sources: string[]): {
+        ok: true;
+        release(): void;
+    } | {
+        ok: false;
+        busy: string[];
+    };
+    start(sources: string[]): Promise<{
+        ok: boolean;
+        pid?: number;
+    }>;
+    estimate: typeof estimateClassify;
+}
+export interface SyncToolResult {
+    text: string;
+    [k: string]: unknown;
+}
+export declare function defaultSyncDeps(env: EnvironmentConfig): SyncToolDeps;
+export declare function runSyncTool(args: Record<string, unknown> | undefined, env: EnvironmentConfig, injected?: SyncToolDeps): Promise<SyncToolResult>;
+//# sourceMappingURL=mcp-sync.d.ts.map

package/dist/lib/mcp-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-sync.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-sync.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAKtD,OAAO,EAAkD,KAAK,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAE/G,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,YAAY,iDAAkD,CAAC;AAI5E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBnB,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC;2GACuG;IACvG,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,IAAI,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC3F,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,EAAE,OAAO,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;AAEtE,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,YAAY,CA+BpE;AAMD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAmDrJ"}

package/dist/lib/mcp-sync.js

@@ -0,0 +1,183 @@
+/**
+ * L5: the MCP tool `align_sync({ action })` - what the background refresh is doing, start it now,
+ * or price the optional AI classification.
+ *
+ * What it does, and what it cannot:
+ * - `status`: per source, scope, last success, status, items last run, discussion pending and
+ *   skip counts, the manual-refresh note for Teams and the exact re-auth command for a refused
+ *   token, and how many stored items wait for their links. Never an item's title, text or URL.
+ * - `run`: starts the SAME detached child a person gets from `align sync --background` and returns
+ *   (Decision 9). A tool call never runs a bulk fetch in the MCP server's own process, and it
+ *   returns inside journey 5's 500 ms. A source already syncing, or being backfilled, is not
+ *   started twice.
+ * - `classify_estimate`: how many LLM calls typing the imported items would cost, and the command
+ *   for the PERSON to run. There is no action that classifies: spending stays with the human
+ *   (Decision 16). No LLM call is made, here or by the child `run` starts.
+ * - Connecting or re-authenticating needs a token only the person can supply: nothing here takes
+ *   one. The input schema is closed, so a `token` or `api_key` property is refused before anything runs.
+ */
+import { backfillDir, liveBackfills, pidAlive, readStatus, reserveSlot, statusPath } from './backfill-state.js';
+import { createConfigStore } from './config.js';
+import { BACKFILL_SOURCES } from './mcp-backfill.js';
+import { estimateClassify } from './sync/classify.js';
+import { scopeStatusHooks } from './scope-real.js';
+import { lockHolder } from './sync/lock.js';
+import { startSyncChild } from './sync/spawn-background.js';
+import { readRows } from './sync/sync-state.js';
+import { collectStatus, renderStatus, TEAMS_NOTE } from './sync/status.js';
+export const SYNC_TOOL = 'align_sync';
+export const SYNC_ACTIONS = ['status', 'run', 'classify_estimate'];
+const DEFAULT_ESTIMATE_ITEMS = 25;
+export const SYNC_TOOL_SCHEMA = {
+    name: SYNC_TOOL,
+    annotations: { readOnlyHint: false, destructiveHint: false },
+    description: 'Check on, or start, the refresh of the sources the user has ALREADY connected into the local graph on this machine. ' +
+        'action "status" says per source when it last synced, whether it needs the person to re-authenticate, and what is still waiting; use it when the user asks whether the graph is up to date or why something is missing. ' +
+        'action "run" starts a background refresh now (it only reads from the sources, makes no LLM calls, and returns at once). ' +
+        'action "classify_estimate" says what typing the imported items with the user\'s own AI key would cost, plus the command for the user to run; it cannot start that. ' +
+        'It never takes a token or key: for a source that is not connected, or whose saved token was refused, the reply gives the exact `align connect <source>` command for the user to run themselves. Do not ask the user to paste a token into the chat.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: { type: 'string', enum: [...SYNC_ACTIONS], description: 'What to do' },
+            source: { type: 'string', enum: [...BACKFILL_SOURCES], description: 'With "run": only this source. Default: every connected source' },
+            max: { type: 'integer', minimum: 1, maximum: 1000, description: 'With "classify_estimate": how many items the person would classify (default 25)' },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+export function defaultSyncDeps(env) {
+    const dbPath = env.localDbPath;
+    if (!dbPath)
+        throw new Error('align_sync needs the local graph path, and this server has none configured.');
+    const config = createConfigStore();
+    const dir = backfillDir();
+    const status = {
+        dbPath, ...scopeStatusHooks(config),
+        isConnected: (id) => Boolean(config.getConnectorFields('local', id)?.['token']),
+        syncRunning: (id) => lockHolder(`sync-${id}`) !== undefined,
+        backfill: (id) => (dir ? readStatus(statusPath(dir, id)) : null),
+        backfillAlive: (s) => s.state === 'running' && pidAlive(s.pid),
+    };
+    return {
+        dbPath, status,
+        needsReauth: (id) => readRows(dbPath, id).some((r) => r.status === 'needs_reauth'),
+        syncRunning: status.syncRunning,
+        backfillRunning: (id) => dir !== null && liveBackfills(dir).some((s) => s.source === id),
+        reserve: (sources) => {
+            const dir = backfillDir();
+            if (dir === null)
+                return { ok: false, busy: sources };
+            const taken = [];
+            for (const s of sources) {
+                const r = reserveSlot(dir, s);
+                if (!r.ok) {
+                    for (const t of taken)
+                        t.release();
+                    return { ok: false, busy: [s] };
+                }
+                taken.push(r);
+            }
+            return { ok: true, release: () => { for (const t of taken)
+                    t.release(); } };
+        },
+        start: (sources) => startSyncChild(sources),
+        estimate: estimateClassify,
+    };
+}
+function isAction(v) {
+    return typeof v === 'string' && SYNC_ACTIONS.includes(v);
+}
+export async function runSyncTool(args, env, injected) {
+    const input = args ?? {};
+    const unknownKeys = Object.keys(input).filter((k) => k !== 'action' && k !== 'source' && k !== 'max');
+    if (unknownKeys.length) {
+        // Names the keys, never their values: a rejected token must not be echoed into the transcript it was typed into.
+        const names = unknownKeys.slice(0, 3).map((k) => JSON.stringify(k.slice(0, 16))).join(', ');
+        throw new Error(`${SYNC_TOOL} takes only "action", "source" and "max", and does not accept ${names}. ` +
+            'It never accepts a token or key: the person connects a source themselves with `align connect <source>`.');
+    }
+    const action = input['action'];
+    if (!isAction(action))
+        throw new Error(`${SYNC_TOOL} requires "action", one of: ${SYNC_ACTIONS.join(', ')}. Call it again with one of those.`);
+    const source = input['source'];
+    if (source !== undefined && (typeof source !== 'string' || !BACKFILL_SOURCES.includes(source))) {
+        throw new Error(`${SYNC_TOOL} "source" must be one of: ${BACKFILL_SOURCES.join(', ')}.`);
+    }
+    const max = input['max'];
+    if (max !== undefined && (typeof max !== 'number' || !Number.isInteger(max) || max < 1 || max > 1000)) {
+        throw new Error(`${SYNC_TOOL} "max" must be a whole number from 1 to 1000.`);
+    }
+    if (env.mode !== 'local-embedded') {
+        throw new Error(`${SYNC_TOOL} refreshes the local graph on this machine, and this server reads a hosted Align graph. ` +
+            'Use the local Align server (align mcp --env local); a hosted graph is refreshed by its connectors.');
+    }
+    const d = injected ?? defaultSyncDeps(env);
+    switch (action) {
+        case 'status': {
+            const r = collectStatus(d.status);
+            return { text: renderStatus(r), sources: r.sources.filter((s) => s.connected), rows_awaiting_relink: r.rows_awaiting_relink };
+        }
+        case 'run':
+            return runAction(typeof source === 'string' ? source : undefined, d);
+        case 'classify_estimate': {
+            const e = d.estimate(d.dbPath, typeof max === 'number' ? max : DEFAULT_ESTIMATE_ITEMS);
+            if (e.available === 0)
+                return { text: 'Nothing to classify: no imported item has a close match that is still untyped.', available: 0 };
+            if (e.provider === undefined) {
+                return {
+                    text: `${e.available} imported items could be typed, but no AI provider is configured, so there is no estimate. Ask the person to run: align ai`,
+                    available: e.available,
+                };
+            }
+            return {
+                text: `Typing ${e.items} of ${e.available} imported items would use up to ${e.calls} LLM calls on your ${e.provider} key. Nothing was sent. To do it, ask the person to run: align sync --classify --max ${e.items}`,
+                available: e.available, items: e.items, max_llm_calls: e.calls, command: `align sync --classify --max ${e.items}`,
+            };
+        }
+    }
+}
+async function runAction(source, d) {
+    const connected = BACKFILL_SOURCES.filter((s) => d.status.isConnected(s));
+    const wanted = source !== undefined ? [source] : connected.filter((s) => s !== 'teams');
+    if (source !== undefined && !d.status.isConnected(source)) {
+        return { started: false, text: `${source} is not connected, so nothing was started. Connecting needs a token only the person can supply. Ask them to run: align connect ${source}` };
+    }
+    if (source === 'teams') {
+        return { started: false, text: `${TEAMS_NOTE} Nothing was started. Ask the person to run: align connect teams` };
+    }
+    if (wanted.length === 0) {
+        return { started: false, text: 'No source is connected, so there is nothing to refresh. Ask the person to run: align connect <source>' };
+    }
+    const reauth = wanted.filter((s) => d.needsReauth(s));
+    const busy = wanted.filter((s) => !reauth.includes(s) && (d.syncRunning(s) || d.backfillRunning(s)));
+    const go = wanted.filter((s) => !reauth.includes(s) && !busy.includes(s));
+    const notes = [];
+    if (reauth.length)
+        notes.push(`${reauth.join(', ')} ${reauth.length === 1 ? 'needs' : 'need'} the person to re-authenticate (the provider refused the saved token); ask them to run: ${reauth.map((s) => `align connect ${s}`).join(' ; ')}.`);
+    if (busy.length)
+        notes.push(`${busy.join(', ')} ${busy.length === 1 ? 'is' : 'are'} already syncing or being backfilled, so nothing new was started for ${busy.length === 1 ? 'it' : 'them'}.`);
+    if (go.length === 0)
+        return { started: false, text: notes.join(' ') };
+    const slot = d.reserve?.(go) ?? { ok: true, release: () => { } };
+    if (!slot.ok) {
+        return { started: false, text: `${slot.busy.join(', ')} ${slot.busy.length === 1 ? 'is' : 'are'} already being started or backfilled, so nothing new was started. ${notes.join(' ')}`.trim() };
+    }
+    let started;
+    try {
+        started = await d.start(go);
+    }
+    finally {
+        slot.release();
+    }
+    if (!started.ok) {
+        return { started: false, text: `The background process could not start, so nothing was started. The person can run it themselves: align sync ${go.join(' ')}`.trim() };
+    }
+    return {
+        started: true,
+        sources: go,
+        text: `Refresh started for ${go.join(', ')}. It runs in the background on this machine, only reads, and makes no LLM calls. Call ${SYNC_TOOL} with action "status" to see how it is going.${notes.length ? ` ${notes.join(' ')}` : ''}`,
+    };
+}
+//# sourceMappingURL=mcp-sync.js.map

package/dist/lib/mcp-sync.js.map

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

package/dist/lib/model-cache.d.ts

@@ -0,0 +1,10 @@
+/**
+ * transformers.js asks a custom cache for a Response and hands one back to store. Keyed on the
+ * request URL rather than a filename: two different repos can carry the same basename, and the
+ * URL is the identity the library itself uses.
+ */
+export declare function modelFileCache(dir: string): {
+    match(request: unknown): Promise<Response | undefined>;
+    put(request: unknown, response: Response): Promise<void>;
+};
+//# sourceMappingURL=model-cache.d.ts.map

package/dist/lib/model-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-cache.d.ts","sourceRoot":"","sources":["../../src/lib/model-cache.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM;mBAQjB,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;iBAIzC,OAAO,YAAY,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;EAQjE"}

package/dist/lib/model-cache.js

@@ -0,0 +1,35 @@
+/**
+ * The on-disk cache transformers.js reads the embedding model through (local-embeddings-wasm.ts,
+ * the binary build). A module of its own so it can be tested without loading the wasm runtime.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ensurePrivateDir, writePrivateFile } from './private-files.js';
+/**
+ * transformers.js asks a custom cache for a Response and hands one back to store. Keyed on the
+ * request URL rather than a filename: two different repos can carry the same basename, and the
+ * URL is the identity the library itself uses.
+ */
+export function modelFileCache(dir) {
+    const keyFor = (request) => {
+        const url = typeof request === 'string'
+            ? request
+            : request.url ?? String(request);
+        return join(dir, createHash('sha256').update(url).digest('hex').slice(0, 32));
+    };
+    return {
+        async match(request) {
+            const path = keyFor(request);
+            return existsSync(path) ? new Response(readFileSync(path)) : undefined;
+        },
+        async put(request, response) {
+            // Owner-only like everything else align keeps (private-files.ts), and tightened when an older
+            // version left the directory wider.
+            ensurePrivateDir(dir);
+            // clone() because the caller still needs to read the body it handed us.
+            writePrivateFile(keyFor(request), Buffer.from(await response.clone().arrayBuffer()));
+        },
+    };
+}
+//# sourceMappingURL=model-cache.js.map

package/dist/lib/model-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-cache.js","sourceRoot":"","sources":["../../src/lib/model-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAU,EAAE;QAC1C,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,QAAQ;YACrC,CAAC,CAAC,OAAO;YACT,CAAC,CAAE,OAA4B,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,OAAgB;YAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,OAAgB,EAAE,QAAkB;YAC5C,8FAA8F;YAC9F,oCAAoC;YACpC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACtB,wEAAwE;YACxE,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/next-step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next-step.d.ts","sourceRoot":"","sources":["../../src/lib/next-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CASpD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEpE;AAED,sHAAsH;AACtH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAGvE;AAmBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIpE;AAOD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAOT;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B;AAID,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAWD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAe/D"}
+{"version":3,"file":"next-step.d.ts","sourceRoot":"","sources":["../../src/lib/next-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CASpD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEpE;AAED,sHAAsH;AACtH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAGvE;AAmBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIpE;AAOD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,MAAM,CAOT;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B;AAID,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAWD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAe/D"}

package/dist/lib/next-step.js

@@ -1,3 +1,4 @@
+import { envFlag } from './destination-name.js';
 /**
  * The agent detected in this repo's project config leads: it is the one the user is most
  * likely sitting in, since the wizard ran from this repo. Then the rest, deduplicated - Claude
@@ -60,7 +61,7 @@ export function firstQuestion(firstTitle) {
 }
 /** Runnable AS PRINTED: bare `align mcp --setup` wires the cloud default, which is not a local user's graph. */
 function mcpSetupCommand(envName) {
-    return envName === 'prod' ? 'align mcp --setup' : `align mcp --setup --env ${envName}`;
+    return `align mcp --setup${envFlag(envName)}`;
 }
 /**
  * The one next action, and it happens in the agent. `inRepo` is the outro (the wizard just

package/dist/lib/next-step.js.map

@@ -1 +1 @@
-{"version":3,"file":"next-step.js","sourceRoot":"","sources":["../../src/lib/next-step.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"next-step.js","sourceRoot":"","sources":["../../src/lib/next-step.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAuBhD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,CAAc;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAiB;IACxD,OAAO,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,4BAA4B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,wBAAwB,GAAG,iDAAiD,CAAC;AACnF,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,eAAe;QAAE,OAAO,KAAK,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,UAA8B;IAC1D,OAAO,UAAU,IAAI,cAAc,CAAC,UAAU,CAAC;QAC7C,CAAC,CAAC,cAAc,UAAU,GAAG;QAC7B,CAAC,CAAC,wCAAwC,CAAC;AAC/C,CAAC;AAED,gHAAgH;AAChH,SAAS,eAAe,CAAC,OAAgB;IACvC,OAAO,oBAAoB,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAK5B;IACC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,0BAA0B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,QAAQ,EAAE,CAAC;IAC7F,CAAC;IACD,OAAO,QAAQ,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,aAAa,QAAQ,EAAE,CAAC;AACnF,CAAC;AAgCD,oEAAoE;AACpE,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,SAAS,CAAC,CAAY;IAC7B,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC;QACjF,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,eAAe,iCAAiC,KAAK,EAAE,CAAC;IAC/F,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,2BAA2B,SAAS,EAAE,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,MAAM,KAAK,GAAG;QACZ,KAAK,IAAI,CAAC,SAAS,EAAE;QACrB,KAAK,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE;KAC3F,CAAC;IACF,IAAI,IAAI,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvB,yFAAyF;QACzF,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9H,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lib/personal-import.d.ts

@@ -18,6 +18,13 @@ export declare function runPersonalImport(items: PersonalImportItem[], client: R
         env: EnvironmentConfig;
         source: string;
     };
+    /** L3: filled with what the gateway STORED and how many batches failed, so the capture report
+     *  can say "imported 20 of 40 (a batch failed)" instead of the fetched count. Untouched when
+     *  the import throws or the process exits before ingest: the caller treats absence as unknown. */
+    result?: {
+        stored?: number;
+        failedBatches?: number;
+    };
 }): Promise<number>;
 /** A single confirm-each candidate: whatever it is, it can render itself for review. */
 export interface ConfirmEachItem {