@aligndottech/cli 0.18.0 → 0.19.1

package/dist/lib/local-relationship-classifier.d.ts

@@ -1,4 +1,5 @@
 import { type DecisionRelationship } from '@aligndottech/connector-core';
+import { type LlmFailure } from './local-llm.js';
 export declare const RELATIONSHIP_TYPES: readonly ["supersedes", "conflicts_with", "contradicts", "duplicates", "clarifies", "relates", "refines", "supports", "questions", "blocks"];
 export type RelationshipType = DecisionRelationship;
 export interface ClassifiedRelationship {
@@ -7,9 +8,11 @@ export interface ClassifiedRelationship {
     reason?: string;
 }
 /**
- * Why a candidate edge could not be typed. Only distinctions the code can actually
- * make: `callChat` cannot tell a timeout from a 429 from an empty body, so there is
- * deliberately no `classifier_timeout`.
+ * Why a candidate edge could not be typed. This enum stays coarse on purpose: since
+ * ALI-692 `callChat` CAN tell a timeout from a 429 from an empty body, but the finer
+ * detail travels on the outcome's `failure` (provider, model, detail) rather than by adding
+ * a reason per failure mode, so presenters name the model without this union growing
+ * a member every time a provider invents a new way to fail.
  */
 export type ClassifierFailureReason = 
 /** Nothing to call: no provider key in the environment, no local Ollama. */
@@ -27,14 +30,29 @@ export type ClassifierFailureReason =
 export type ClassificationOutcome = {
     ok: true;
     relationship: ClassifiedRelationship;
-} | {
+}
+/**
+ * `failure` carries WHICH provider and model failed, when one did. It is on the
+ * value rather than on a module getter so a presenter reads the diagnosis for the
+ * candidate it actually asked about - the reason `align check` could previously
+ * report classifier_error with no remedy attached.
+ */
+ | {
     ok: false;
     reason: ClassifierFailureReason;
+    failure?: LlmFailure;
 };
 interface DecisionLite {
     title: string;
     summary: string;
 }
+/**
+ * Design constraint for any future multi-model adjudication here (ALI-692): if two
+ * models ever judge one question (a conflict verdict plus a second opinion, a jury),
+ * the pair must span model FAMILIES. A family's leniency is systematic, so same-family
+ * agreement is one opinion counted twice, not independent confirmation. Today exactly
+ * one model answers, so there is nothing to enforce - this note is the requirement.
+ */
 export declare function classifyRelationship(subject: DecisionLite, candidate: DecisionLite): Promise<ClassificationOutcome>;
 export {};
 //# sourceMappingURL=local-relationship-classifier.d.ts.map

package/dist/lib/local-relationship-classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-relationship-classifier.d.ts","sourceRoot":"","sources":["../../src/lib/local-relationship-classifier.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,8BAA8B,CAAC;AAOtC,eAAO,MAAM,kBAAkB,8IAAyB,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB;AACjC,4EAA4E;AAC1E,YAAY;AACd,sEAAsE;GACpE,kBAAkB;AACpB,sFAAsF;GACpF,wBAAwB;AAC1B;;;;GAIG;GACD,sBAAsB,CAAC;AAE3B,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,sBAAsB,CAAA;CAAE,GAClD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAEnD,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAehC"}
+{"version":3,"file":"local-relationship-classifier.d.ts","sourceRoot":"","sources":["../../src/lib/local-relationship-classifier.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAK1F,eAAO,MAAM,kBAAkB,8IAAyB,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB;AACjC,4EAA4E;AAC1E,YAAY;AACd,sEAAsE;GACpE,kBAAkB;AACpB,sFAAsF;GACpF,wBAAwB;AAC1B;;;;GAIG;GACD,sBAAsB,CAAC;AAE3B,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,sBAAsB,CAAA;CAAE;AACpD;;;;;GAKG;GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzE,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAoBhC"}

package/dist/lib/local-relationship-classifier.js

@@ -7,7 +7,7 @@
 // returned a bare null for all three causes, and the caller - unable to tell them
 // apart, or apart from "classified, no conflict" - reported `aligned`.
 import { DECISION_RELATIONSHIPS, DETERMINISTIC_TEMPERATURE, isDecisionRelationship, } from '@aligndottech/connector-core';
-import { callChat, getUnvettedOllamaModels, hasConfiguredProvider } from './local-llm.js';
+import { callChatDetailed, hasConfiguredProvider } from './local-llm.js';
 // ALI-219: the canonical decision-graph vocabulary is the single source of truth
 // (connector-core). The local classifier must only emit types the graph accepts,
 // or a local edge is invalid on personal->org sync. Re-exported for callers/tests.
@@ -19,21 +19,31 @@ const SYSTEM_PROMPT = "You classify how decision B relates to decision A in a so
 function buildUserPrompt(a, b) {
     return `Decision A: ${a.title}. ${a.summary}\n\nDecision B: ${b.title}. ${b.summary}`;
 }
+/**
+ * Design constraint for any future multi-model adjudication here (ALI-692): if two
+ * models ever judge one question (a conflict verdict plus a second opinion, a jury),
+ * the pair must span model FAMILIES. A family's leniency is systematic, so same-family
+ * agreement is one opinion counted twice, not independent confirmation. Today exactly
+ * one model answers, so there is nothing to enforce - this note is the requirement.
+ */
 export async function classifyRelationship(subject, candidate) {
     // ALI-218/219: pin the shared deterministic temperature so the same decision
     // pair types the same way every run - offline relationship detection must be
     // deterministic, and the value is the one both paths share (connector-core).
-    const raw = await callChat(SYSTEM_PROMPT, buildUserPrompt(subject, candidate), {
+    const result = await callChatDetailed(SYSTEM_PROMPT, buildUserPrompt(subject, candidate), {
         temperature: DETERMINISTIC_TEMPERATURE,
     });
-    if (!raw) {
-        // Order matters: an unvetted local model is a more specific diagnosis than either of
-        // the other two, and `hasConfiguredProvider()` is env-only so it cannot see it.
-        if (getUnvettedOllamaModels())
-            return { ok: false, reason: 'unvetted_local_model' };
-        return { ok: false, reason: hasConfiguredProvider() ? 'classifier_error' : 'no_llm_key' };
+    if (!result.ok) {
+        // Each mapping below reads the failure the call RETURNED, so it describes this
+        // candidate's attempt and nothing else. `hasConfiguredProvider()` is still the
+        // tiebreak for no_provider, because it is env-only and so is the only thing that
+        // can tell "keys exist but every one was rejected" from "nothing is configured".
+        const reason = result.failure.kind === 'unrecognised_local_models' ? 'unvetted_local_model'
+            : result.failure.kind === 'provider_stopped' ? 'classifier_error'
+                : hasConfiguredProvider() ? 'classifier_error' : 'no_llm_key';
+        return { ok: false, reason, failure: result.failure };
     }
-    const relationship = parseRelationship(raw);
+    const relationship = parseRelationship(result.text);
     return relationship ? { ok: true, relationship } : { ok: false, reason: 'classifier_unparseable' };
 }
 function parseRelationship(text) {

package/dist/lib/local-relationship-classifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-relationship-classifier.js","sourceRoot":"","sources":["../../src/lib/local-relationship-classifier.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,kFAAkF;AAClF,6EAA6E;AAC7E,EAAE;AACF,6EAA6E;AAC7E,kFAAkF;AAClF,uEAAuE;AAEvE,OAAO,EACL,sBAAsB,EAEtB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE1F,iFAAiF;AACjF,iFAAiF;AACjF,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAsCzD,MAAM,aAAa,GACjB,yFAAyF;IACzF,oDAAoD,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,wDAAwD;IACzI,0HAA0H;IAC1H,sHAAsH,CAAC;AAEzH,SAAS,eAAe,CAAC,CAAe,EAAE,CAAe;IACvD,OAAO,eAAe,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,mBAAmB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAqB,EACrB,SAAuB;IAEvB,6EAA6E;IAC7E,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE;QAC7E,WAAW,EAAE,yBAAyB;KACvC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,qFAAqF;QACrF,gFAAgF;QAChF,IAAI,uBAAuB,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;QACpF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IAC5F,CAAC;IACD,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;AACrG,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAA+D,CAAC;QAC/F,8EAA8E;QAC9E,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnD,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACvG,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;QACtE,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3F,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"local-relationship-classifier.js","sourceRoot":"","sources":["../../src/lib/local-relationship-classifier.ts"],"names":[],"mappings":"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"}

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

@@ -8,8 +8,43 @@ import type { EnvironmentConfig } from './config.js';
  * contact us and have no tenant, so counting them needs an explicit consent flow and its own
  * storage (`telemetry_events.tenant_id` is `NOT NULL REFERENCES tenants(id)`).
  *
- * Set `ALIGN_TELEMETRY=0` to opt out entirely.
+ * Set `ALIGN_TELEMETRY=0` (or `false` / `no` / `off`) to opt out entirely.
  */
 export declare const TELEMETRY_TIMEOUT_MS = 2000;
 export declare function recordCommandUsage(env: EnvironmentConfig, command: string): Promise<void>;
+/**
+ * The `--env` the user actually typed, including one Commander handed to a parent.
+ *
+ * `align import git --env local` leaves the subcommand's own `opts()` empty, because `--env`
+ * is declared on both and Commander resolves that in the parent's favour (align-cli#79, which
+ * fixed the same read for the import commands via subcommandOpts). Reading `.opts()` here
+ * would send a local command's event to the cloud default - this slice's own bug, one layer up.
+ */
+export declare function envFlagOf(cmd: {
+    optsWithGlobals(): Record<string, unknown>;
+}): string | undefined;
+/**
+ * Resolve the env the command actually addressed, then report against THAT.
+ *
+ * The postAction hook used to hand over `getEnvironment(getDefaultEnv())`, and
+ * `align setup --local` deliberately leaves the default env alone (local-mode.ts), so a
+ * machine that had ever run `align login` reported every `ask --env local` to the cloud -
+ * the one thing PR #77 said local mode does not do. Only the three-member `local` command
+ * group was excluded, and no local user types `align local ask`.
+ *
+ * `preferLocalEmbedded` is deliberately NOT passed: it is a routing preference for the
+ * read commands, and asking for it here would be a second opinion on where the command
+ * went. The flag and ALIGN_ENV are what the user chose explicitly, and those are what a
+ * consent decision may rest on. Note that preference and this gate are today mutually
+ * exclusive by arithmetic rather than by design - the redirect fires only when the cloud env
+ * has no token, which is the same condition recordCommandUsage returns on - so if that token
+ * check is ever relaxed to count tokenless users, pass the preference here as well.
+ *
+ * `setup` is suppressed once local-embedded is configured. The interactive "Local only" choice
+ * sets no flag, and the default env stays cloud on purpose, so the only evidence the session was
+ * local is what the run left behind - and a `setup` that ends with the machine in local mode is
+ * a local session. It costs one activation count on a once-per-machine command, in the direction
+ * that cannot leak.
+ */
+export declare function recordInvocationUsage(envFlag: string | undefined, command: string): Promise<void>;
 //# sourceMappingURL=usage-telemetry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"usage-telemetry.d.ts","sourceRoot":"","sources":["../../src/lib/usage-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C/F"}
+{"version":3,"file":"usage-telemetry.d.ts","sourceRoot":"","sources":["../../src/lib/usage-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAiB1C,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD/F;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE;IAAE,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CASjG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/lib/usage-telemetry.js

@@ -7,17 +7,36 @@
  * contact us and have no tenant, so counting them needs an explicit consent flow and its own
  * storage (`telemetry_events.tenant_id` is `NOT NULL REFERENCES tenants(id)`).
  *
- * Set `ALIGN_TELEMETRY=0` to opt out entirely.
+ * Set `ALIGN_TELEMETRY=0` (or `false` / `no` / `off`) to opt out entirely.
  */
 export const TELEMETRY_TIMEOUT_MS = 2_000;
+/**
+ * Set and not recognisably ON means OFF. Enumerating the falsy words instead - `0|false|no|off` -
+ * guesses at what a user will type, and every guess that misses is a live send by someone who
+ * believes they opted out: `disabled` and `n` both sent. Trimmed, because a trailing space or
+ * newline comes free from a `.env` file or a here-doc. Unset is ON, which is the documented
+ * cloud default and the only value this cannot see.
+ */
+const OPT_IN_VALUES = new Set(['1', 'true', 'yes', 'on']);
+function telemetryOptedOut() {
+    const raw = process.env['ALIGN_TELEMETRY'];
+    if (raw === undefined || raw.trim() === '')
+        return false;
+    return !OPT_IN_VALUES.has(raw.trim().toLowerCase());
+}
 export async function recordCommandUsage(env, command) {
-    if (process.env['ALIGN_TELEMETRY'] === '0')
+    if (telemetryOptedOut())
         return;
     // `align local ...` is the explicitly-offline path. Its caller may still hold a cloud token
-    // (the hook resolves the DEFAULT env, not the one the command used), so the token check below
+    // (the hook may resolve an env other than the one the command used), so the token check below
     // is not enough on its own.
     if (command === 'local' || command.startsWith('local '))
         return;
+    // The mode is the consent boundary (PR #77: cloud is opt-out, local is no-phone-home). It has
+    // to gate on its own because a token 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')
+        return;
     if (!env.authToken || !env.tenantId)
         return;
     // A blackholing proxy hangs rather than rejecting, so a bare await would freeze the CLI after
@@ -60,4 +79,55 @@ export async function recordCommandUsage(env, command) {
         clearTimeout(timer);
     }
 }
+/**
+ * The `--env` the user actually typed, including one Commander handed to a parent.
+ *
+ * `align import git --env local` leaves the subcommand's own `opts()` empty, because `--env`
+ * is declared on both and Commander resolves that in the parent's favour (align-cli#79, which
+ * fixed the same read for the import commands via subcommandOpts). Reading `.opts()` here
+ * would send a local command's event to the cloud default - this slice's own bug, one layer up.
+ */
+export function envFlagOf(cmd) {
+    const opts = cmd.optsWithGlobals();
+    const value = opts['env'];
+    if (typeof value === 'string')
+        return value;
+    // `align setup --local` is how a user ENTERS local mode, and it is not spelled `--env local`,
+    // so reading only `env` reported the one command whose whole purpose is going private. Checked
+    // after `env` so an explicitly typed cloud env still wins.
+    if (opts['local'] === true)
+        return 'local';
+    return undefined;
+}
+/**
+ * Resolve the env the command actually addressed, then report against THAT.
+ *
+ * The postAction hook used to hand over `getEnvironment(getDefaultEnv())`, and
+ * `align setup --local` deliberately leaves the default env alone (local-mode.ts), so a
+ * machine that had ever run `align login` reported every `ask --env local` to the cloud -
+ * the one thing PR #77 said local mode does not do. Only the three-member `local` command
+ * group was excluded, and no local user types `align local ask`.
+ *
+ * `preferLocalEmbedded` is deliberately NOT passed: it is a routing preference for the
+ * read commands, and asking for it here would be a second opinion on where the command
+ * went. The flag and ALIGN_ENV are what the user chose explicitly, and those are what a
+ * consent decision may rest on. Note that preference and this gate are today mutually
+ * exclusive by arithmetic rather than by design - the redirect fires only when the cloud env
+ * has no token, which is the same condition recordCommandUsage returns on - so if that token
+ * check is ever relaxed to count tokenless users, pass the preference here as well.
+ *
+ * `setup` is suppressed once local-embedded is configured. The interactive "Local only" choice
+ * sets no flag, and the default env stays cloud on purpose, so the only evidence the session was
+ * local is what the run left behind - and a `setup` that ends with the machine in local mode is
+ * 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) {
+    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)), command);
+}
 //# 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":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAsB,EAAE,OAAe;IAC9E,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,GAAG;QAAE,OAAO;IACnD,4FAA4F;IAC5F,8FAA8F;IAC9F,4BAA4B;IAC5B,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAChE,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO;IAE5C,8FAA8F;IAC9F,yFAAyF;IACzF,oDAAoD;IACpD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,MAAM,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC9C,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,EAAE,CAAC;IACX,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,KAAK,CAAC,GAAG,GAAG,CAAC,UAAU,mBAAmB,EAAE;gBAC1C,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,GAAG,CAAC,SAAS,EAAE;oBACxC,aAAa,EAAE,GAAG,CAAC,QAAQ;iBAC5B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,SAAS,EAAE,aAAa;oBACxB,QAAQ,EAAE,YAAY;oBACtB,QAAQ,EAAE,KAAK;oBACf,UAAU,EAAE,EAAE,OAAO,EAAE;iBACxB,CAAC;aACH,CAAC;YACF,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,0FAA0F;QAC1F,8EAA8E;IAChF,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"usage-telemetry.js","sourceRoot":"","sources":["../../src/lib/usage-telemetry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligndottech/cli",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "mcpName": "io.github.aligndottech/cli",
   "type": "module",
   "description": "Align CLI - capture decisions, check alignment, and manage connectors",