@aligndottech/cli 0.48.0 → 0.50.0

package/dist/lib/usage-telemetry.js

@@ -1,6 +1,8 @@
 import { ALIGN_HOSTED_GATEWAY_URL } from './config.js';
 import { telemetryDisabledByEnv } from './telemetry-env.js';
-import { inHookContext } from './hook-context.js';
+import { inHookContext, markHookContext } from './hook-context.js';
+import { inCi } from './telemetry-ci.js';
+import { maybeShowTelemetryNotice, storeEnvOptOut } from './telemetry-consent.js';
 import pkg from '../../package.json' with { type: 'json' };
 /**
  * ALI-403: emit one `cli.command` event per invocation so cloud CLI activation and weekly
@@ -8,24 +10,45 @@ import pkg from '../../package.json' with { type: 'json' };
  *
  * Cloud mode is opt-out: a cloud user is already on an authenticated connection to our
  * gateway, so an event about a call already being made is not a new phone-home. Local-embedded
- * mode has two tiers (ALI-954, superseding the ALI-618 "nothing by default" for local mode):
- * - Two anonymous BEACONS send by default: `cli.funnel.install` (once, on the first ever run,
- *   see recordInstallBeacon) and `cli.funnel.setup_completed`. They exist so the funnel has a
- *   denominator - opt-in usage alone cannot tell a 10% consent rate from 90%.
- * - Everything else (`cli.command`, the other funnel stages) sends only with the stored
- *   consent (`config.ts`'s `getTelemetryConsent`, set by the one-time prompt at the end of
- *   setup, default No). `--local` users have no account and no tenant, so there is nothing
- *   to authenticate an event against - the consent is the gate.
+ * mode is opt-out too since C6, disclosed by a one-time notice (telemetry-consent.ts) that cli.ts
+ * prints to stderr before the first send - nothing local sends until it has printed
+ * (localTierAllows). An install that answered No to the pre-C6 setup question ('declined')
+ * keeps that answer for usage; the two ALI-954 beacons (install, setup_completed) still send
+ * for it, as they did. `--local` users have no account and no tenant, so there is nothing to
+ * authenticate an event against - the notice, and the stored decision, are the gate.
  * Both modes send only a command name, never arguments or content. docs/telemetry.md lists
  * every event and field, and telemetry-docs-parity.test.ts keeps that page true.
  *
- * `ALIGN_TELEMETRY=0` and `DO_NOT_TRACK=1` (telemetry-env.ts) turn everything off, both tiers,
- * in both modes, over a granted local consent included (ALI-618 D3b - one consent model, not
- * two). `align telemetry off` stores 'off', which does the same thing without an env var.
+ * `ALIGN_TELEMETRY=0` and `DO_NOT_TRACK=1` (telemetry-env.ts), and running in CI
+ * (telemetry-ci.ts, C6), turn everything off, both tiers, in both modes, over a granted local
+ * consent included (ALI-618 D3b - one consent model, not two). `align telemetry off` stores 'off', which does the same thing without an env var.
  */
 export const TELEMETRY_TIMEOUT_MS = 2_000;
 function telemetryOptedOut() {
-    return telemetryDisabledByEnv() !== undefined;
+    return telemetryDisabledByEnv() !== undefined || inCi();
+}
+/**
+ * THE one predicate for "a stored answer forbids sending anything", read by every send path:
+ * local usage, local stages and beacons (localTierAllows), the install beacon's first-run
+ * consumption, cloud cli.command and cloud funnel stages, and `align telemetry status`.
+ * 'off' is `align telemetry off`; 'declined' is a No to the pre-C6 setup question. The privacy
+ * page promises "if you turned telemetry off earlier, it stays off", with no mode attached, so
+ * both stop everything in both modes (review of e794c6e, then the coordinator's call that a
+ * declined cloud user is off too).
+ */
+export function storedAnswerForbidsSending(consent) {
+    return consent === 'off' || consent === 'declined';
+}
+/** The predicate above, read from the store. A store that cannot be read forbids - the direction
+ *  that sends nothing. */
+async function storedAnswerForbidsSendingNow() {
+    try {
+        const { createConfigStore } = await import('./config.js');
+        return storedAnswerForbidsSending(createConfigStore().getTelemetryConsent());
+    }
+    catch {
+        return true;
+    }
 }
 /**
  * POST with a hard timeout, and never throw - telemetry must never fail or delay a command. A
@@ -34,7 +57,7 @@ function telemetryOptedOut() {
  * waiting even if the transport ignores the signal. Shared by the cloud and local-embedded send
  * paths below, which were two copies of this exact race before extraction (fresh-context review).
  */
-async function postWithTimeout(url, init) {
+async function postWithTimeout(url, init, capMs = TELEMETRY_TIMEOUT_MS) {
     const controller = new AbortController();
     let giveUp = () => { };
     const abandoned = new Promise((resolve) => {
@@ -43,9 +66,9 @@ async function postWithTimeout(url, init) {
     const timer = setTimeout(() => {
         controller.abort();
         giveUp();
-    }, TELEMETRY_TIMEOUT_MS);
+    }, capMs);
     try {
-        await Promise.race([fetch(url, { ...init, signal: controller.signal }), abandoned]);
+        await Promise.race([fetch(url, { ...init, redirect: 'error', signal: controller.signal }), abandoned]);
     }
     catch {
         // Telemetry must never fail a command - see "resolves when the gateway rejects" and
@@ -56,14 +79,42 @@ async function postWithTimeout(url, init) {
     }
 }
 /**
- * ALI-618 D3b: what `align telemetry status` prints. Takes the consent decision as a plain
- * argument rather than reading `config.ts` itself, so the two consent MODELS stay visibly
- * distinct in one function a reader can hold in their head - cloud's opt-out default and
- * local's stored decision (ALI-954: three values, and the two default-on beacons named where
- * usage is off but they are not) - with the env switches as the thing that overrides both,
- * checked first.
+ * The hard cap on the one send that is awaited: the first-run install beacon. Once per install,
+ * so ordinary runs never pay it.
+ */
+export const INSTALL_BEACON_CAP_MS = 800;
+async function postDelivered(url, init, capMs) {
+    const controller = new AbortController();
+    let timer;
+    const capped = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            // Resolve first: the abort below rejects the fetch, and that must not read as 'failed'.
+            resolve('timeout');
+            controller.abort();
+        }, capMs);
+    });
+    try {
+        return await Promise.race([
+            fetch(url, { ...init, redirect: 'error', signal: controller.signal }).then(() => 'delivered', () => 'failed'),
+            capped,
+        ]);
+    }
+    catch {
+        return 'failed';
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * ALI-618 D3b: what `align telemetry status` prints. Takes the consent decision and whether the
+ * C6 notice has printed as plain arguments rather than reading `config.ts` itself, so the
+ * model stays visible in one function a reader can hold in their head - cloud's opt-out
+ * default, and local's stored decision or the notice (ALI-954: the two default-on beacons named
+ * where usage is off but they are not) - with the env switches and CI overriding both, checked
+ * first.
  */
-export function getTelemetryStatus(env, localConsent) {
+export function getTelemetryStatus(env, localConsent, noticeShown = false, offByEnv) {
     const envSwitch = telemetryDisabledByEnv();
     if (envSwitch === 'DO_NOT_TRACK') {
         return { enabled: false, reason: 'off: DO_NOT_TRACK is set - nothing is sent' };
@@ -71,27 +122,42 @@ export function getTelemetryStatus(env, localConsent) {
     if (envSwitch === 'ALIGN_TELEMETRY') {
         return { enabled: false, reason: 'off: ALIGN_TELEMETRY is set to an opt-out value - nothing is sent' };
     }
+    if (inCi()) {
+        return { enabled: false, reason: 'off: running in CI - nothing is sent' };
+    }
+    if (localConsent === 'off' && offByEnv !== undefined) {
+        return { enabled: false, reason: `off (${offByEnv.via} was set on ${offByEnv.at.slice(0, 10)}); turn it back on with: align telemetry on` };
+    }
+    if (env.mode !== 'local-embedded' && storedAnswerForbidsSending(localConsent)) {
+        const why = localConsent === 'declined' ? 'you declined when asked' : 'you ran `align telemetry off`';
+        return { enabled: false, reason: `off: ${why} - nothing is sent, cloud events included` };
+    }
     if (env.mode === 'local-embedded') {
-        // ALI-954: "off" here is about usage. The two beacons still send unless the user ran
-        // `align telemetry off` (stored 'off') - and the line has to say so, or "off" would be
-        // read as "nothing is sent" over a beacon that still is.
-        const beacons = ' - the two anonymous counts (install, setup completed) still send; `align telemetry off` stops those too';
         if (localConsent === 'granted') {
-            return { enabled: true, reason: 'on: local mode, you opted in when asked' };
+            return { enabled: true, reason: 'on: local mode, you opted in' };
         }
         if (localConsent === 'declined') {
-            return { enabled: false, reason: `off: local mode, you declined when asked${beacons}` };
+            // A No to the old setup question is off, beacons included (review of e794c6e).
+            return { enabled: false, reason: 'off: local mode, you declined when asked - nothing is sent' };
         }
         if (localConsent === 'off') {
             return { enabled: false, reason: 'off: local mode, you ran `align telemetry off` - nothing is sent' };
         }
-        return { enabled: false, reason: `off: local mode, you have not been asked yet${beacons}` };
+        // C6: opt-out, disclosed by the one-time notice. Nothing sends before it has printed.
+        if (noticeShown) {
+            return { enabled: true, reason: 'on: local mode, opt-out (the one-time notice explained it) - `align telemetry off` stops it' };
+        }
+        return { enabled: false, reason: 'off: local mode, nothing has been sent yet - a one-time notice prints before the first send' };
     }
     return { enabled: true, reason: 'on: cloud mode, opt-out default' };
 }
-export async function recordCommandUsage(env, command) {
+export async function recordCommandUsage(env, command, opts = {}) {
     if (telemetryOptedOut())
         return;
+    // C6: an agent hook runs on the agent's clock, many times a session, with nobody watching -
+    // a usage ping from there counts an editing loop, not a person running a command.
+    if (inHookContext())
+        return;
     // `align local ...` is the explicitly-offline path. Its caller may still hold a cloud token
     // (the hook may resolve an env other than the one the command used), so the token check below
     // is not enough on its own.
@@ -103,11 +169,13 @@ export async function recordCommandUsage(env, command) {
     // can be in scope without cloud consent: ALIGN_TOKEN exported into the shell, or a
     // logged-in default env resolved by the caller.
     if (env.mode === 'local-embedded') {
-        await recordAnonymousCommandUsage(command);
+        await recordAnonymousCommandUsage(command, opts.capMs);
         return;
     }
     if (!env.authToken || !env.tenantId)
         return;
+    if (await storedAnswerForbidsSendingNow())
+        return;
     await postWithTimeout(`${env.gatewayUrl}/telemetry/ingest`, {
         method: 'POST',
         headers: {
@@ -121,14 +189,14 @@ export async function recordCommandUsage(env, command) {
             platform: 'cli',
             properties: { command },
         }),
-    });
+    }, opts.capMs);
 }
 /**
  * ALI-618: the local-embedded sibling of the cloud send above. No Authorization, no tenant -
- * there is neither. Gated on a machine-local consent decision instead of a token, and the
- * payload carries exactly three fields (install id, command name, CLI version) so there is
- * nothing here for the gateway's strict schema to reject and nothing beyond what the consent
- * prompt promises. See usage-telemetry-anonymous.test.ts.
+ * there is neither. Gated on the C6 notice and the machine-local decision instead of a token,
+ * and the payload carries exactly three fields (install id, command name, CLI version) so there
+ * is nothing here for the gateway's strict schema to reject and nothing beyond what the notice
+ * promises. See usage-telemetry-anonymous.test.ts.
  *
  * Targets `ALIGN_HOSTED_GATEWAY_URL`, never a `gatewayUrl` off the env - local-embedded mode
  * makes no HTTP call for its own work (an embedded local DB client, see gateway-client.ts), so
@@ -137,12 +205,12 @@ export async function recordCommandUsage(env, command) {
  * `http://localhost:8080`, silently discarded, for every user who had not separately stood up
  * a local dev gateway.
  */
-async function recordAnonymousCommandUsage(command) {
+async function recordAnonymousCommandUsage(command, capMs) {
     const { createConfigStore } = await import('./config.js');
     const config = createConfigStore();
-    if (config.getTelemetryConsent() !== 'granted')
+    if (!localTierAllows(config.getTelemetryConsent(), 'command', noticeShownOn(config)))
         return;
-    await postAnonymous({ installId: config.getInstallId(), command: commandPathOf(command), cliVersion: pkg.version });
+    await postAnonymous({ installId: config.getInstallId(), command: commandPathOf(command), cliVersion: pkg.version }, capMs);
 }
 /**
  * ALI-795: the command groups whose second word is a SUBCOMMAND, mirroring the gateway's
@@ -150,7 +218,9 @@ async function recordAnonymousCommandUsage(command) {
  * agree or pings silently 400. A query-taking command (ask, search, capture...) sends its
  * top-level word only, so a user's one-word query can never ride the command field.
  */
-const SUBCOMMAND_PARENTS = new Set(['context', 'decisions', 'env', 'import', 'links', 'spaces', 'telemetry']);
+export const SUBCOMMAND_PARENTS = new Set([
+    'connect', 'context', 'decisions', 'env', 'import', 'links', 'spaces', 'telemetry',
+]);
 /** "import git" stays whole (activation-by-source is the point); "ask <anything>" and
  *  every non-group command collapse to the top-level word. */
 function commandPathOf(command) {
@@ -203,7 +273,49 @@ export const FUNNEL_STAGES = [
     ...SESSION_IMPORT_STAGES,
     // C1: bare `align` handed the terminal to a coding agent. Carries the agent name only.
     'agent_launched',
+    // L7: one per source per completed sync. Carries a count and four closed enums (SyncMeasurement).
+    'source_synced',
+];
+/**
+ * L7: what `source_synced` reports. A count and four closed enums, nothing else - never a repo, a
+ * host, a space, a project, a title or an id. Each list is a mirror of the gateway's (align-stack
+ * telemetryAnonymousRoutes.ts: SOURCE_VALUES, SYNC_OUTCOME_VALUES, SCOPE_VALUES,
+ * SYNC_TRIGGER_VALUES), and `telemetry-server-parity.test.ts` checks them against that file.
+ * A value outside a list is a silent 400 there, so it is dropped here instead of sent.
+ *
+ * `SYNC_TRIGGERS` has no `mcp` although the plan wanted one: the gateway's list does not (it is
+ * `connect`, `background`, `manual`), and a sync an agent starts over MCP runs as the background
+ * child, so it reports `background`.
+ */
+export const SYNC_SOURCES = [
+    'git', 'docs', 'github', 'jira', 'confluence', 'slack', 'teams', 'zoom', 'gitlab', 'linear', 'notion',
 ];
+export const SYNC_OUTCOMES = ['ok', 'partial', 'needs_reauth', 'error'];
+export const SYNC_SCOPES = ['yours', 'team'];
+export const SYNC_TRIGGERS = ['connect', 'background', 'manual'];
+/** The gateway's `MAX_FUNNEL_COUNT`: above it the whole ping is a 400. */
+export const MAX_FUNNEL_COUNT = 100_000;
+/**
+ * The `source_synced` body fields, built from the fixed whitelist and never by stripping a richer
+ * object. Undefined when anything is missing or outside its closed list: the caller then sends
+ * nothing, because the gateway requires all five and answers a partial body with a silent 400.
+ */
+function syncFields(m) {
+    if (m === null || typeof m !== 'object')
+        return undefined;
+    const r = m;
+    const count = r['count'];
+    if (typeof count !== 'number' || !Number.isInteger(count) || count < 0)
+        return undefined;
+    const pick = (list, v) => list.find((x) => x === v);
+    const source = pick(SYNC_SOURCES, r['source']);
+    const outcome = pick(SYNC_OUTCOMES, r['outcome']);
+    const scope = pick(SYNC_SCOPES, r['scope']);
+    const trigger = pick(SYNC_TRIGGERS, r['trigger']);
+    if (!source || !outcome || !scope || !trigger)
+        return undefined;
+    return { count: Math.min(count, MAX_FUNNEL_COUNT), source, outcome, scope, trigger };
+}
 /**
  * ALI-954: the two stages that send BY DEFAULT in local mode, with no consent - the
  * denominator of the funnel. `install` goes through recordInstallBeacon; `setup_completed`
@@ -231,7 +343,7 @@ export const BEACON_STAGES = ['install', 'setup_completed'];
  * offers setup_started at several checkpoints because local-mode consent arrives
  * mid-wizard, and this is how it knows which offer landed (lib/setup-funnel.ts).
  */
-export async function recordFunnelStage(env, stage, command, measurement) {
+export async function recordFunnelStage(env, stage, command, measurement, opts = {}) {
     // The whole body is guarded: telemetry must never fail or delay a command (the same
     // invariant postWithTimeout enforces for the network half, extended to the config
     // half). The concrete case: an emitter call site inside a command's try block plus a
@@ -247,6 +359,12 @@ export async function recordFunnelStage(env, stage, command, measurement) {
         // rather than one per call site.
         if (inHookContext())
             return false;
+        // L7: the sync measurement is built and checked before anything else, so a ping the gateway
+        // would 400 is never counted as sent. Local only: the endpoint that knows this stage is the
+        // anonymous one, and a sync reads the local graph.
+        const syncMeasured = stage === 'source_synced' ? syncFields(measurement) : undefined;
+        if (stage === 'source_synced' && (syncMeasured === undefined || env.mode !== 'local-embedded'))
+            return false;
         const { createConfigStore } = await import('./config.js');
         const config = createConfigStore();
         if (stage === 'first_useful_decision' && config.wasFunnelStageRecorded(stage))
@@ -259,8 +377,8 @@ export async function recordFunnelStage(env, stage, command, measurement) {
         // re-sending forever.
         const isLocal = env.mode === 'local-embedded';
         const canSend = isLocal
-            ? localTierAllows(config.getTelemetryConsent(), stage)
-            : Boolean(env.authToken && env.tenantId);
+            ? localTierAllows(config.getTelemetryConsent(), stage, noticeShownOn(config))
+            : Boolean(env.authToken && env.tenantId) && !storedAnswerForbidsSending(config.getTelemetryConsent());
         if (!canSend)
             return false;
         if (stage === 'first_useful_decision')
@@ -273,11 +391,12 @@ export async function recordFunnelStage(env, stage, command, measurement) {
         // stage, so a future call site passing a measurement alongside, say, `mcp_wired` would
         // 400 the whole ping - and the catch below swallows that, so the stage would go silently
         // missing rather than fail loudly. Dropping the two fields keeps the stage itself.
-        const measured = measurement && 'count' in measurement && SESSION_IMPORT_STAGES.includes(stage)
-            ? { count: measurement.count, agent: measurement.agent }
-            : measurement && stage === 'agent_launched'
-                ? { agent: measurement.agent }
-                : {};
+        const measured = syncMeasured ??
+            (measurement && 'agent' in measurement && 'count' in measurement && SESSION_IMPORT_STAGES.includes(stage)
+                ? { count: measurement.count, agent: measurement.agent }
+                : measurement && 'agent' in measurement && stage === 'agent_launched'
+                    ? { agent: measurement.agent }
+                    : {});
         if (isLocal) {
             await postAnonymous({
                 installId: config.getInstallId(),
@@ -287,7 +406,7 @@ export async function recordFunnelStage(env, stage, command, measurement) {
                 // Spread rather than set: the gateway's schema is `.strict()`, and an explicit
                 // undefined key is still a key.
                 ...measured,
-            });
+            }, opts.capMs);
             return true;
         }
         await postWithTimeout(`${env.gatewayUrl}/telemetry/ingest`, {
@@ -312,28 +431,34 @@ export async function recordFunnelStage(env, stage, command, measurement) {
     }
 }
 /**
- * ALI-954: whether a local-mode stage may send, given the stored decision. A beacon stage
- * sends unless the user ran `align telemetry off` (stored 'off'); every other stage needs
- * a granted consent. A prompt-declined consent ('declined') is a decision about USAGE and
- * leaves the beacons on - that split is the ticket's decision, and docs/telemetry.md says
- * it in the user's words.
+ * Whether a local-mode event may send, given the stored decision and whether the one-time
+ * notice has printed (C6). Local mode is opt-out since C6, and the notice is the disclosure:
+ * - stored 'off' (`align telemetry off`) stops everything, and so does 'declined' (a No to the
+ *   pre-C6 setup question): the privacy page promises "if you turned telemetry off earlier, it
+ *   stays off", so a stored No stops the beacons too (review of e794c6e);
+ * - otherwise everything sends with a granted consent (`align telemetry on`) or after the notice.
+ *   Beacons and usage now share one rule; BEACON_STAGES remains the documented set.
+ * Every caller has already returned under an env switch, in CI and (for usage) in a hook.
  */
-function localTierAllows(consent, stage) {
-    if (BEACON_STAGES.includes(stage))
-        return consent !== 'off';
-    return consent === 'granted';
+function localTierAllows(consent, stage, noticeShown) {
+    if (storedAnswerForbidsSending(consent))
+        return false;
+    return consent === 'granted' || noticeShown;
+}
+function noticeShownOn(config) {
+    return config.getTelemetryNoticeShownAt() !== undefined;
 }
 /**
  * The anonymous payload, the one place its shape is spelled. Targets ALIGN_HOSTED_GATEWAY_URL,
  * never a `gatewayUrl` off the env - see recordAnonymousCommandUsage for why.
  */
-async function postAnonymous(payload) {
+async function postAnonymous(payload, capMs) {
     const target = process.env['ALIGN_GATEWAY_URL'] || ALIGN_HOSTED_GATEWAY_URL;
     await postWithTimeout(`${target}/telemetry/anonymous`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify(payload),
-    });
+    }, capMs);
 }
 /**
  * ALI-954: the install beacon - the funnel's denominator. Sent from the preAction hook in
@@ -361,6 +486,13 @@ export async function recordInstallBeacon(commandPath) {
     try {
         if (commandPath === 'telemetry' || commandPath.startsWith('telemetry '))
             return false;
+        // C6: a CI job is not an install, so it must not consume the first run; nor do the runs
+        // nobody is reading (an agent's `mcp` server, a hook, a run inside a launched agent) - the
+        // notice is skipped there, so the beacon would have nothing to follow.
+        if (inCi() || inHookContext() || commandPath === 'mcp' || commandPath.startsWith('mcp '))
+            return false;
+        if (process.env['ALIGN_WRAPPED'])
+            return false;
         const { createConfigStore } = await import('./config.js');
         const { resolveEnv } = await import('./resolve-env.js');
         const config = createConfigStore();
@@ -369,19 +501,46 @@ export async function recordInstallBeacon(commandPath) {
         const env = config.getEnvironment(resolveEnv(undefined, { preferLocalEmbedded: true }));
         if (env.authToken)
             return false;
-        config.markFunnelStageRecorded('install');
-        if (telemetryOptedOut())
+        // A decision that says "never" consumes the first run, so the beacon is never sent later
+        // either: an env switch, `align telemetry off`, or a stored No.
+        const consent = config.getTelemetryConsent();
+        if (telemetryOptedOut() || storedAnswerForbidsSending(consent)) {
+            config.markFunnelStageRecorded('install');
+            return false;
+        }
+        // Not told yet (no notice: no terminal, or the notice failed): the first run is NOT consumed,
+        // so the beacon goes out after the first run that does show the notice.
+        if (!localTierAllows(consent, 'install', noticeShownOn(config)))
             return false;
-        if (!localTierAllows(config.getTelemetryConsent(), 'install'))
+        // Marked BEFORE the send, as a check-and-set on the store, so two first runs started together
+        // mostly send one beacon. Not atomic across processes: the store is a JSON file with no lock,
+        // so two processes that both read it before either writes can still both send. The cost is
+        // one duplicate install row, in the overcount direction, and only on a racing first run.
+        if (!config.claimFunnelStage('install'))
             return false;
-        await postAnonymous({
-            installId: config.getInstallId(),
-            command: 'align',
-            cliVersion: pkg.version,
-            stage: 'install',
-            os: process.platform,
-        });
-        return true;
+        // Awaited, unlike every other send: the stage is once-only and already claimed, so a request
+        // that never left (the command exited first, `align status` does) would lose this install
+        // from the funnel forever. Capped at INSTALL_BEACON_CAP_MS.
+        // - A failed connection (nothing reached a gateway) releases the claim; the next run retries,
+        //   and a refusal costs no wait.
+        // - A timeout keeps the claim: the request was written and may have arrived, so that is the
+        //   one attempt. Releasing it made every run behind a silent gateway pay the cap again and
+        //   send again. The cost is an install lost if that one request really was dropped.
+        const target = process.env['ALIGN_GATEWAY_URL'] || ALIGN_HOSTED_GATEWAY_URL;
+        const outcome = await postDelivered(`${target}/telemetry/anonymous`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                installId: config.getInstallId(),
+                command: 'align',
+                cliVersion: pkg.version,
+                stage: 'install',
+                os: process.platform,
+            }),
+        }, INSTALL_BEACON_CAP_MS);
+        if (outcome === 'failed')
+            config.releaseFunnelStage('install');
+        return outcome === 'delivered';
     }
     catch {
         // Telemetry must never fail or delay a command; the funnel loses one row.
@@ -450,12 +609,42 @@ export function envFlagOf(cmd) {
  * a local session. It costs one activation count on a once-per-machine command, in the direction
  * that cannot leak.
  */
-export async function recordInvocationUsage(envFlag, command) {
+export async function recordInvocationUsage(envFlag, command, opts = {}) {
+    // L7: the detached `align sync --background` child is a machine running a refresh, not a person
+    // running a command (its per-source `source_synced` pings are the measurement). Decided from the
+    // command's own flag, the way hook invocations are, so one place says so.
+    if (opts.background === true)
+        return;
     const { createConfigStore } = await import('./config.js');
     const { resolveEnv } = await import('./resolve-env.js');
     const config = createConfigStore();
     if (command === 'setup' && config.getEnvironment('local').mode === 'local-embedded')
         return;
-    await recordCommandUsage(config.getEnvironment(resolveEnv(envFlag, { preferLocalEmbedded: true })), command);
+    await recordCommandUsage(config.getEnvironment(resolveEnv(envFlag, { preferLocalEmbedded: true })), command, opts.capMs === undefined ? {} : { capMs: opts.capMs });
+}
+/**
+ * C6: what runs before every command (cli.ts's preAction): the one-time notice, then the
+ * install beacon, both awaited. On every run but the first, the beacon returns after a config
+ * read and sends nothing. On the first run it is the one send that is awaited, capped at
+ * INSTALL_BEACON_CAP_MS (see recordInstallBeacon), so the command cannot exit before it is
+ * delivered. Every other event stays fire-and-forget. `hook` is the invocation's own flags (`check --hook` /
+ * `--advisory`), marked here because the command's action, which also marks it, runs later.
+ */
+export async function beginInvocationTelemetry(commandPath, opts) {
+    if (opts.hook)
+        markHookContext();
+    try {
+        const { createConfigStore } = await import('./config.js');
+        const { resolveEnv } = await import('./resolve-env.js');
+        const config = createConfigStore();
+        // Before the notice and before anything can send: an env opt-out becomes a stored one.
+        storeEnvOptOut(config);
+        const env = config.getEnvironment(resolveEnv(undefined, { preferLocalEmbedded: true }));
+        maybeShowTelemetryNotice(config, { command: commandPath, hook: opts.hook, cloudSignedIn: Boolean(env.authToken) });
+    }
+    catch {
+        // Telemetry must never fail a command. No notice means nothing that waits on it sends.
+    }
+    return recordInstallBeacon(commandPath);
 }
 //# sourceMappingURL=usage-telemetry.js.map

package/dist/lib/usage-telemetry.js.map

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

package/dist/lib/xdg.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The XDG base-directory variables. The XDG spec says a relative value is invalid and must be
+ * ignored. It matters beyond correctness: an agent that loads a repo's `.env` (cn, Cline) hands
+ * its MCP children whatever that file says, and XDG_CONFIG_HOME=./evilcfg once made
+ * `align mcp --env local` copy the user's local.db into the repo. One helper, used everywhere.
+ */
+export declare const XDG_VARS: readonly ["XDG_CONFIG_HOME", "XDG_DATA_HOME", "XDG_CACHE_HOME", "XDG_STATE_HOME"];
+export type XdgVar = (typeof XDG_VARS)[number];
+/**
+ * A path under /proc or /dev/fd names another process's view of the filesystem (`/proc/self/cwd`
+ * is whatever directory the reader runs in): never a real config home.
+ */
+export declare function procLike(p: string): boolean;
+/**
+ * The real path of `p`: its nearest existing ancestor resolved through symlinks, plus the rest.
+ * A path that does not exist yet still resolves through the links above it.
+ */
+export declare function realPathOf(p: string): string;
+/** The variable's value only when it is an absolute path outside /proc and /dev/fd; otherwise undefined. */
+export declare function absoluteXdg(env: Record<string, string | undefined>, name: XdgVar | string): string | undefined;
+/**
+ * Delete every relative XDG_* (and any under /proc or /dev/fd) from `env` (process.env at startup, before anything reads it:
+ * `conf` and env-paths read these themselves). An empty value is left alone, as it already
+ * means unset. Returns the names removed.
+ */
+export declare function dropRelativeXdg(env: Record<string, string | undefined>): string[];
+//# sourceMappingURL=xdg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xdg.d.ts","sourceRoot":"","sources":["../../src/lib/xdg.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,mFAAoF,CAAC;AAC1G,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED,4GAA4G;AAC5G,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9G;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAUjF"}