@aligndottech/cli 0.37.1 → 0.38.0

package/dist/lib/sessions/memory-files.js

@@ -0,0 +1,235 @@
+/**
+ * ALI-810: Claude Code's own auto-memory as a second, already-curated decision source.
+ *
+ * ALI-808 mines raw transcripts. This reads the notes the harness already decided were worth
+ * keeping: `~/.claude/projects/<project>/memory/*.md`, one fact per file, with a `type` in
+ * frontmatter. Higher precision per file and far cheaper to parse - no noise filtering, no
+ * repeat-loop exclusion, no plan-file resolution.
+ *
+ * ## What is verified, and what is not
+ *
+ * There is no captured memory-file fixture, because this environment has no memory directory
+ * at all (checked: `find ~/.claude -type d -name memory` is empty while `~/.claude/projects`
+ * exists). Under ALI-808's own gate - "the gate is the fixture, not the agent name" - that
+ * would normally mean shipping `locate` and refusing to parse, the way `gemini-cli` and
+ * `cursor` do.
+ *
+ * The difference here is that the format is DOCUMENTED by its producer rather than reverse
+ * engineered, so the fixtures are built from Anthropic's own published description rather
+ * than from a guess (https://code.claude.com/docs/en/memory, read 2026-09-09). Everything
+ * this module relies on is quoted from that page:
+ *
+ *   - the directory is `~/.claude/projects/<project>/memory/`, `<project>` derived from the
+ *     git repository, so all worktrees and subdirectories of one repo share it;
+ *   - it holds a `MEMORY.md` index plus one topic file per memory, with arbitrary names;
+ *   - Claude records the kind in a `type` frontmatter field with exactly four values:
+ *     `user`, `feedback`, `project`, `reference`;
+ *   - a `modified` frontmatter field carries an ISO-8601 write time;
+ *   - "Claude Code never adds frontmatter to a file that has none", so a memory file may
+ *     legitimately carry no frontmatter at all;
+ *   - `autoMemoryDirectory` in settings.json relocates the directory.
+ *
+ * **The ALI-810 ticket also names `description` and `originSessionId` frontmatter fields.
+ * The documentation describes neither.** They may well exist - the ticket was written from a
+ * real machine and this one has no memory directory to check - but nothing here depends on
+ * them, because a field this module cannot confirm is a field it must not require. If they
+ * turn out to be real, `parseMemoryFile` already returns them under `extra` and a follow-up
+ * can promote them without touching any caller.
+ */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, dirname, join } from 'node:path';
+import { findFilesRecursive, sortByMtimeDesc } from './fs-scan.js';
+import { claudeCodeAdapter } from './adapters/claude-code.js';
+/** The four kinds Claude Code records, verbatim from the documentation. */
+export const MEMORY_TYPES = ['user', 'feedback', 'project', 'reference'];
+/**
+ * The two kinds that are decision-shaped.
+ *
+ * `project` is "ongoing work, deadlines, and decisions that Claude can't derive from the code
+ * or git history" and `feedback` is "corrections you give Claude and approaches you confirm" -
+ * both are things somebody decided. `user` is a person's role and working preferences, and
+ * `reference` is where to find a dashboard. Neither is a decision, and importing them would
+ * put personal notes into a decision graph.
+ */
+export const DECISION_MEMORY_TYPES = ['project', 'feedback'];
+/** The index file, never a memory in its own right. */
+export const MEMORY_INDEX_FILENAME = 'MEMORY.md';
+/**
+ * Where this project's memory directory is, if anywhere.
+ *
+ * Resolution order, and the reason for it:
+ *
+ * 1. `autoMemoryDirectory` from `~/.claude/settings.json`. Reading it matters because the
+ *    failure direction without it is silent: a user who relocated the directory would get an
+ *    empty list, which is indistinguishable from "no memories yet".
+ * 2. Otherwise, the `memory/` sibling of this project's Claude Code session files. The docs
+ *    say `<project>` is derived from the git repository, and the exact slug encoding is not
+ *    documented - so rather than guess at it, this reuses the cwd matching ALI-808 already
+ *    proved (each session file records its own `cwd`) and takes the directory those files
+ *    sit in. That is correct for worktrees and subdirectories for free, because they share
+ *    one project directory.
+ *
+ * Returns [] when the agent has never run here, which is the normal case and not an error.
+ */
+export function locateMemoryDirs(cwd) {
+    const configured = readAutoMemoryDirectory();
+    if (configured)
+        return [configured];
+    const sessionFiles = claudeCodeAdapter.locateSessionFiles(cwd);
+    const dirs = new Set();
+    for (const file of sessionFiles)
+        dirs.add(join(dirname(file), 'memory'));
+    return [...dirs];
+}
+/** Memory topic files for this project, newest first. `MEMORY.md` is excluded: it is an index
+ *  of the others, so importing it would duplicate every memory as one more candidate. */
+export function locateMemoryFiles(cwd) {
+    const found = [];
+    for (const dir of locateMemoryDirs(cwd)) {
+        for (const file of findFilesRecursive(dir, /\.md$/)) {
+            if (basename(file) !== MEMORY_INDEX_FILENAME)
+                found.push(file);
+        }
+    }
+    return sortByMtimeDesc(found);
+}
+function readAutoMemoryDirectory() {
+    let raw;
+    try {
+        raw = readFileSync(join(homedir(), '.claude', 'settings.json'), 'utf8');
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // A settings file we cannot parse is not ours to repair, and guessing past it would be
+        // worse than falling back to the documented default location.
+        return null;
+    }
+    const value = parsed?.['autoMemoryDirectory'];
+    if (typeof value !== 'string' || value.length === 0)
+        return null;
+    // Documented constraint: "must be an absolute path or start with ~/".
+    if (value.startsWith('~/'))
+        return join(homedir(), value.slice(2));
+    return value;
+}
+/**
+ * Parses one memory file.
+ *
+ * The frontmatter reader deliberately handles only `key: value` scalars on one line, which is
+ * every field the documentation describes. Anything else - a nested map, a list, a block
+ * scalar - is left in `extra` as its raw text if it is a simple scalar and otherwise ignored,
+ * rather than half-understood. js-yaml is a devDependency here, not a runtime one, so pulling
+ * a YAML parser into shipped CLI code would be a new dependency for two scalar fields.
+ *
+ * Returns null only for an unreadable file.
+ */
+export function parseMemoryFile(filePath) {
+    let text;
+    try {
+        text = readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const { frontmatter, body } = splitFrontmatter(text);
+    const rawType = frontmatter['type'];
+    const type = isMemoryType(rawType) ? rawType : null;
+    const modified = frontmatter['modified'] ?? null;
+    const extra = {};
+    for (const [k, v] of Object.entries(frontmatter)) {
+        if (k !== 'type' && k !== 'modified')
+            extra[k] = v;
+    }
+    return { filePath, type, modified, extra, body };
+}
+function isMemoryType(value) {
+    return value !== undefined && MEMORY_TYPES.includes(value);
+}
+/**
+ * Splits `---\n...\n---\n` off the front. A file with no frontmatter is the documented normal
+ * case, not a malformed one, so it yields an empty map and the whole text as the body.
+ */
+function splitFrontmatter(text) {
+    const normalized = text.replace(/\r\n/g, '\n');
+    if (!normalized.startsWith('---\n'))
+        return { frontmatter: {}, body: normalized.trim() };
+    const end = normalized.indexOf('\n---', 3);
+    if (end === -1) {
+        // An opening fence with no closing one is not frontmatter. Treating the rest of the file
+        // as key/value would silently swallow the content.
+        return { frontmatter: {}, body: normalized.trim() };
+    }
+    const block = normalized.slice(4, end);
+    const after = normalized.slice(end + 4);
+    const frontmatter = {};
+    for (const line of block.split('\n')) {
+        const colon = line.indexOf(':');
+        if (colon === -1)
+            continue;
+        const key = line.slice(0, colon).trim();
+        let value = line.slice(colon + 1).trim();
+        if (!key || !value)
+            continue;
+        // Strip one layer of matching quotes, which is how an ISO timestamp is often written.
+        if ((value.startsWith('"') && value.endsWith('"') && value.length > 1) ||
+            (value.startsWith("'") && value.endsWith("'") && value.length > 1)) {
+            value = value.slice(1, -1);
+        }
+        frontmatter[key] = value;
+    }
+    return { frontmatter, body: after.trim() };
+}
+/** First markdown heading, else the filename stem with `_`/`-` as spaces. */
+function titleFor(file) {
+    const heading = file.body.split('\n').find(l => /^#{1,6}\s+\S/.test(l));
+    if (heading)
+        return heading.replace(/^#{1,6}\s+/, '').trim();
+    return basename(file.filePath).replace(/\.md$/, '').replace(/[_-]+/g, ' ').trim();
+}
+/**
+ * The decision-shaped memories among these files.
+ *
+ * Three separate reasons a file is dropped, all deliberate:
+ *   - `type` is `user` or `reference`: classified, and not a decision.
+ *   - `type` is absent or unrecognised: NOT classified. Importing it would be a guess about
+ *     personal notes, so it is skipped rather than defaulted into a decision.
+ *   - the body is empty: nothing to review.
+ */
+export function extractMemoryDecisions(filePaths) {
+    const candidates = [];
+    for (const filePath of filePaths) {
+        const parsed = parseMemoryFile(filePath);
+        if (!parsed)
+            continue;
+        // This null check is RUNTIME-REDUNDANT and kept deliberately. Replacing it with a no-op
+        // leaves every test green, because DECISION_MEMORY_TYPES cannot contain null so the next
+        // line drops an unclassified file anyway. Deleting it does NOT leave the suite green:
+        // `tsc` then reports TS2345 and TS2322, because the narrowing to MemoryType is what lets
+        // the next line and the push below compile. The enforcing mechanism is the compiler
+        // rather than a test, which is the honest reason it survives a mutation run - so do not
+        // remove it as dead code.
+        if (parsed.type === null)
+            continue;
+        if (!DECISION_MEMORY_TYPES.includes(parsed.type))
+            continue;
+        if (parsed.body.length === 0)
+            continue;
+        candidates.push({
+            filePath,
+            type: parsed.type,
+            title: titleFor(parsed),
+            body: parsed.body,
+            timestamp: parsed.modified,
+            memoryDir: dirname(filePath),
+        });
+    }
+    return candidates;
+}
+//# sourceMappingURL=memory-files.js.map

package/dist/lib/sessions/memory-files.js.map

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

package/dist/lib/sessions/source-url.d.ts

@@ -7,4 +7,15 @@ export declare function parseSessionSourceUrl(url: string): {
     sessionId: string;
     messageId: string;
 } | null;
+/**
+ * ALI-810: memory files are not sessions, so they get their own scheme rather than being
+ * squeezed into `<agent>-session://<sessionId>/<messageId>` with invented ids.
+ *
+ * Built from the project directory name and the topic file's stem, both of which are stable
+ * for a given memory across rewrites - Claude edits a topic file in place rather than making
+ * a new one. That stability is the point: the gateway upserts on `(tenant_id, source_url)`,
+ * so re-running the import after Claude has revised a memory updates the decision instead of
+ * adding a second copy of it.
+ */
+export declare function buildMemorySourceUrl(memoryDir: string, filePath: string): string;
 //# sourceMappingURL=source-url.d.ts.map

package/dist/lib/sessions/source-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-url.d.ts","sourceRoot":"","sources":["../../../src/lib/sessions/source-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C;6CAC6C;AAC7C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpG;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWpH"}
+{"version":3,"file":"source-url.d.ts","sourceRoot":"","sources":["../../../src/lib/sessions/source-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C;6CAC6C;AAC7C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpG;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWpH;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIhF"}

package/dist/lib/sessions/source-url.js

@@ -17,4 +17,19 @@ export function parseSessionSourceUrl(url) {
     }
     return null;
 }
+/**
+ * ALI-810: memory files are not sessions, so they get their own scheme rather than being
+ * squeezed into `<agent>-session://<sessionId>/<messageId>` with invented ids.
+ *
+ * Built from the project directory name and the topic file's stem, both of which are stable
+ * for a given memory across rewrites - Claude edits a topic file in place rather than making
+ * a new one. That stability is the point: the gateway upserts on `(tenant_id, source_url)`,
+ * so re-running the import after Claude has revised a memory updates the decision instead of
+ * adding a second copy of it.
+ */
+export function buildMemorySourceUrl(memoryDir, filePath) {
+    const project = memoryDir.split(/[\\/]/).filter(Boolean).at(-2) ?? 'unknown-project';
+    const topic = (filePath.split(/[\\/]/).pop() ?? 'unknown').replace(/\.md$/, '');
+    return `claude-code-memory://${project}/${topic}`;
+}
 //# sourceMappingURL=source-url.js.map

package/dist/lib/sessions/source-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-url.js","sourceRoot":"","sources":["../../../src/lib/sessions/source-url.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAyB,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AAExG;6CAC6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,KAAgB,EAAE,SAAiB,EAAE,SAAiB;IAC1F,OAAO,GAAG,KAAK,cAAc,SAAS,IAAI,SAAS,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,GAAG,KAAK,aAAa,CAAC;QACrC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"source-url.js","sourceRoot":"","sources":["../../../src/lib/sessions/source-url.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAyB,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AAExG;6CAC6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,KAAgB,EAAE,SAAiB,EAAE,SAAiB;IAC1F,OAAO,GAAG,KAAK,cAAc,SAAS,IAAI,SAAS,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,GAAG,KAAK,aAAa,CAAC;QACrC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,QAAgB;IACtE,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC;IACrF,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChF,OAAO,wBAAwB,OAAO,IAAI,KAAK,EAAE,CAAC;AACpD,CAAC"}

package/dist/lib/setup-funnel.d.ts

@@ -0,0 +1,41 @@
+import type { EnvironmentConfig } from './config.js';
+/**
+ * ALI-949: the setup wizard's two funnel stages, carried through `runSetup` so bare
+ * `align` and `align setup` share one emitter (both run runSetup's body).
+ *
+ * `started` BUFFERS rather than sends. When a mode branch begins nothing may be sendable
+ * on a fresh install: cloud has no token until login, and local mode asks for consent
+ * mid-wizard (ALI-794 puts the found-decisions moment before any question, and that order
+ * is not negotiable here). So the wizard offers the current env at each checkpoint - the
+ * top of the local value phase, after consent, the top of cloud setup, after login - and
+ * this object sends at the first offer the emitter reports as sent. Sendability is
+ * recordFunnelStage's decision, not repeated here.
+ *
+ * Within one wizard run, "once" is per IDENTITY rather than once in total. A local-mode
+ * ping is keyed on the machine's installId; a cloud ping on the tenant. Nothing joins the
+ * two, so a fresh-install user who consents locally and then chooses "sync to the cloud"
+ * would otherwise leave `setup_started` under one identity and `setup_completed` under the
+ * other (fresh-context review on #279). A later checkpoint on the OTHER transport therefore
+ * sends again under its own identity; the same transport never repeats in the run. There is
+ * no cross-run memory here: one object is created per `runSetup` call, and a re-run of the
+ * wizard is a new setup_started, which is what the funnel wants (the reader counts an
+ * install once per stage regardless - `cli_activation_funnel.py`'s countIf(> 0)).
+ *
+ * What that means for the funnel: in local mode `setup_started` says "started, and got as
+ * far as consenting" rather than "typed the command". A user who declines consent is never
+ * counted at any stage, which is the consent model, not a gap.
+ *
+ * Offers are serialised through one promise chain because call sites fire them without
+ * awaiting (`void funnel.started(env)` - a slow gateway must not delay the wizard), so two
+ * offers can overlap; the second waits for the first's verdict before deciding to send.
+ * `completed` queues behind the started chain too (Copilot on #279): a started send still
+ * in flight when the wizard finishes must not be overtaken, or the install's two events
+ * reach the gateway out of order. By the outro the started send has long settled, so this
+ * costs nothing in practice and is the ordering guarantee when it has not.
+ */
+export interface SetupFunnel {
+    started(env: EnvironmentConfig): Promise<void>;
+    completed(env: EnvironmentConfig): Promise<void>;
+}
+export declare function createSetupFunnel(): SetupFunnel;
+//# sourceMappingURL=setup-funnel.d.ts.map

package/dist/lib/setup-funnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-funnel.d.ts","sourceRoot":"","sources":["../../src/lib/setup-funnel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAMD,wBAAgB,iBAAiB,IAAI,WAAW,CAuB/C"}

package/dist/lib/setup-funnel.js

@@ -0,0 +1,28 @@
+import { recordFunnelStage } from './usage-telemetry.js';
+const transportOf = (env) => (env.mode === 'local-embedded' ? 'anonymous' : 'cloud');
+export function createSetupFunnel() {
+    // The transports setup_started has been sent on so far.
+    let startedChain = Promise.resolve(new Set());
+    let completedChain = Promise.resolve(false);
+    return {
+        async started(env) {
+            startedChain = startedChain.then(async (sentOn) => {
+                const transport = transportOf(env);
+                if (sentOn.has(transport))
+                    return sentOn;
+                const sent = await recordFunnelStage(env, 'setup_started', 'setup');
+                return sent ? new Set([...sentOn, transport]) : sentOn;
+            });
+            await startedChain;
+        },
+        async completed(env) {
+            // Capture the previous link BEFORE reassigning, or the new chain waits on itself.
+            const previous = completedChain;
+            completedChain = startedChain
+                .then(() => previous)
+                .then((sent) => (sent ? true : recordFunnelStage(env, 'setup_completed', 'setup')));
+            await completedChain;
+        },
+    };
+}
+//# sourceMappingURL=setup-funnel.js.map

package/dist/lib/setup-funnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-funnel.js","sourceRoot":"","sources":["../../src/lib/setup-funnel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA2CzD,MAAM,WAAW,GAAG,CAAC,GAAsB,EAAa,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAEnH,MAAM,UAAU,iBAAiB;IAC/B,wDAAwD;IACxD,IAAI,YAAY,GAAoC,OAAO,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/E,IAAI,cAAc,GAAqB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAG;YACf,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBAChD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;gBACnC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;oBAAE,OAAO,MAAM,CAAC;gBACzC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;gBACpE,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACzD,CAAC,CAAC,CAAC;YACH,MAAM,YAAY,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,GAAG;YACjB,kFAAkF;YAClF,MAAM,QAAQ,GAAG,cAAc,CAAC;YAChC,cAAc,GAAG,YAAY;iBAC1B,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC;iBACpB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACtF,MAAM,cAAc,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/telemetry-consent.d.ts

@@ -3,18 +3,27 @@
  * carry every unrelated accessor `createConfigStore()` exposes.
  */
 export interface TelemetryConsentStore {
-    getTelemetryConsent(): 'granted' | 'declined' | undefined;
-    setTelemetryConsent(value: 'granted' | 'declined'): void;
+    getTelemetryConsent(): 'granted' | 'declined' | 'off' | undefined;
+    setTelemetryConsent(value: 'granted' | 'declined' | 'off'): void;
 }
 /**
  * ALI-618 D3: the one-time local-mode consent prompt, shown from `runLocalSetup()`.
  *
- * Never asks twice - a decision already on disk (granted OR declined) is left alone. Never
- * prompts without a TTY on both streams: a piped `setup --local` run hangs on a prompt it
- * cannot answer, and a closed stdin crashes clack's raw-mode init AFTER the real setup work has
- * already succeeded (the align-cli#118 lesson, `setup-local-non-tty.test.ts`). A non-interactive
- * run leaves consent UNSET rather than implicitly declined - a scripted first run may be a CI
- * smoke test, not a real user's choice, and it can still be asked on a later interactive run.
+ * Never asks twice - a decision already on disk (granted, declined, or `align telemetry off`)
+ * is left alone. Never prompts without a TTY on both streams: a piped `setup --local` run
+ * hangs on a prompt it cannot answer, and a closed stdin crashes clack's raw-mode init AFTER
+ * the real setup work has already succeeded (the align-cli#118 lesson,
+ * `setup-local-non-tty.test.ts`). A non-interactive run leaves consent UNSET rather than
+ * implicitly declined - a scripted first run may be a CI smoke test, not a real user's choice,
+ * and it can still be asked on a later interactive run.
+ *
+ * ALI-954: an env var that already turns everything off (`DO_NOT_TRACK=1`, `ALIGN_TELEMETRY=0`)
+ * skips the question with a one-line note - asking would imply the answer matters - and
+ * leaves the decision unset for the same reason as the non-interactive case.
+ *
+ * The question is about USAGE (which commands you run). The two anonymous counts the docs
+ * describe (install, setup completed) are not what is being asked about here and send either
+ * way; `align telemetry off` is what stops those (docs/telemetry.md).
  *
  * Default is No: anything other than an explicit yes - the default answer, or Ctrl-C - leaves
  * telemetry off (D3).

package/dist/lib/telemetry-consent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-consent.d.ts","sourceRoot":"","sources":["../../src/lib/telemetry-consent.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,IAAI,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1D,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC;CAC1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,qBAAqB,EAC7B,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"telemetry-consent.d.ts","sourceRoot":"","sources":["../../src/lib/telemetry-consent.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,IAAI,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;IAClE,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC;CAClE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,qBAAqB,EAC7B,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/lib/telemetry-consent.js

@@ -1,13 +1,23 @@
 import * as p from '@clack/prompts';
+import { telemetryDisabledByEnv } from './telemetry-env.js';
 /**
  * ALI-618 D3: the one-time local-mode consent prompt, shown from `runLocalSetup()`.
  *
- * Never asks twice - a decision already on disk (granted OR declined) is left alone. Never
- * prompts without a TTY on both streams: a piped `setup --local` run hangs on a prompt it
- * cannot answer, and a closed stdin crashes clack's raw-mode init AFTER the real setup work has
- * already succeeded (the align-cli#118 lesson, `setup-local-non-tty.test.ts`). A non-interactive
- * run leaves consent UNSET rather than implicitly declined - a scripted first run may be a CI
- * smoke test, not a real user's choice, and it can still be asked on a later interactive run.
+ * Never asks twice - a decision already on disk (granted, declined, or `align telemetry off`)
+ * is left alone. Never prompts without a TTY on both streams: a piped `setup --local` run
+ * hangs on a prompt it cannot answer, and a closed stdin crashes clack's raw-mode init AFTER
+ * the real setup work has already succeeded (the align-cli#118 lesson,
+ * `setup-local-non-tty.test.ts`). A non-interactive run leaves consent UNSET rather than
+ * implicitly declined - a scripted first run may be a CI smoke test, not a real user's choice,
+ * and it can still be asked on a later interactive run.
+ *
+ * ALI-954: an env var that already turns everything off (`DO_NOT_TRACK=1`, `ALIGN_TELEMETRY=0`)
+ * skips the question with a one-line note - asking would imply the answer matters - and
+ * leaves the decision unset for the same reason as the non-interactive case.
+ *
+ * The question is about USAGE (which commands you run). The two anonymous counts the docs
+ * describe (install, setup completed) are not what is being asked about here and send either
+ * way; `align telemetry off` is what stops those (docs/telemetry.md).
  *
  * Default is No: anything other than an explicit yes - the default answer, or Ctrl-C - leaves
  * telemetry off (D3).
@@ -17,6 +27,11 @@ export async function maybeRequestTelemetryConsent(config, interactive) {
         return;
     if (!interactive)
         return;
+    const envSwitch = telemetryDisabledByEnv();
+    if (envSwitch !== undefined) {
+        p.log.info(`Telemetry is off (${envSwitch} is set), so nothing is sent and you won't be asked.`);
+        return;
+    }
     const answer = await p.confirm({
         message: 'Help improve Align? Send an anonymous count of which commands you run - no code, no ' +
             'decisions, no file names, ever. You can change this any time with `align telemetry off`.',

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry-consent.js","sourceRoot":"","sources":["../../src/lib/telemetry-consent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAWpC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAA6B,EAC7B,WAAoB;IAEpB,IAAI,MAAM,CAAC,mBAAmB,EAAE,KAAK,SAAS;QAAE,OAAO;IACvD,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;QAC7B,OAAO,EACL,sFAAsF;YACtF,0FAA0F;QAC5F,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IAEH,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACrF,CAAC"}
+{"version":3,"file":"telemetry-consent.js","sourceRoot":"","sources":["../../src/lib/telemetry-consent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAW5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAA6B,EAC7B,WAAoB;IAEpB,IAAI,MAAM,CAAC,mBAAmB,EAAE,KAAK,SAAS;QAAE,OAAO;IACvD,IAAI,CAAC,WAAW;QAAE,OAAO;IAEzB,MAAM,SAAS,GAAG,sBAAsB,EAAE,CAAC;IAC3C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,SAAS,sDAAsD,CAAC,CAAC;QACjG,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;QAC7B,OAAO,EACL,sFAAsF;YACtF,0FAA0F;QAC5F,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;IAEH,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AACrF,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * ALI-954: the two environment variables that turn ALL telemetry off - both tiers, the
+ * default-on beacons included. Its own module so the consent prompt (telemetry-consent.ts)
+ * can ask the same question without importing the emitter, which setup.test.ts mocks down to
+ * one function.
+ *
+ * The two read in opposite directions, each erring toward sending nothing:
+ * - `ALIGN_TELEMETRY` (ours, ALI-618): set and not recognisably ON means OFF. Enumerating the
+ *   falsy words instead guesses at what a user will type, and every miss is a live send by
+ *   someone who believes they opted out.
+ * - `DO_NOT_TRACK` (consoledonottrack.com, the cross-tool convention): set and not
+ *   recognisably OFF means "do not track". The convention says `1`; a user who exports `true`
+ *   means the same thing, and `DO_NOT_TRACK=0` is the one spelling that means nothing.
+ * Both trimmed, because a trailing newline comes free from a `.env` file or a here-doc.
+ */
+export type TelemetryEnvSwitch = 'DO_NOT_TRACK' | 'ALIGN_TELEMETRY';
+/** The variable that disables telemetry, or undefined when neither does. */
+export declare function telemetryDisabledByEnv(): TelemetryEnvSwitch | undefined;
+//# sourceMappingURL=telemetry-env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-env.d.ts","sourceRoot":"","sources":["../../src/lib/telemetry-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAKpE,4EAA4E;AAC5E,wBAAgB,sBAAsB,IAAI,kBAAkB,GAAG,SAAS,CAMvE"}

package/dist/lib/telemetry-env.js

@@ -0,0 +1,13 @@
+const ON_VALUES = new Set(['1', 'true', 'yes', 'on']);
+const OFF_VALUES = new Set(['0', 'false', 'no', 'off']);
+/** The variable that disables telemetry, or undefined when neither does. */
+export function telemetryDisabledByEnv() {
+    const dnt = process.env['DO_NOT_TRACK']?.trim().toLowerCase();
+    if (dnt !== undefined && dnt !== '' && !OFF_VALUES.has(dnt))
+        return 'DO_NOT_TRACK';
+    const ours = process.env['ALIGN_TELEMETRY']?.trim().toLowerCase();
+    if (ours !== undefined && ours !== '' && !ON_VALUES.has(ours))
+        return 'ALIGN_TELEMETRY';
+    return undefined;
+}
+//# sourceMappingURL=telemetry-env.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-env.js","sourceRoot":"","sources":["../../src/lib/telemetry-env.ts"],"names":[],"mappings":"AAiBA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AACtD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAExD,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,cAAc,CAAC;IACnF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACxF,OAAO,SAAS,CAAC;AACnB,CAAC"}