agentskeptic 6.1.0 → 6.3.0

package/dist/telemetry/telemetryConsent.test.js

@@ -0,0 +1,165 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { resetCliInstallIdModuleStateForTests } from "./cliInstallId.js";
+import { hasPersistedTelemetryPreference, isProductActivationTelemetryEnabled, readPersistedTelemetryBoolean, tryPersistTelemetryPreference, } from "./telemetryConsent.js";
+function sandboxHome(home) {
+    process.env.HOME = home;
+    if (process.platform === "win32") {
+        process.env.USERPROFILE = home;
+    }
+}
+describe("telemetryConsent", () => {
+    let prevHome;
+    let prevUserProfile;
+    let prevTelemetry;
+    beforeEach(() => {
+        prevHome = process.env.HOME;
+        prevUserProfile = process.env.USERPROFILE;
+        prevTelemetry = process.env.AGENTSKEPTIC_TELEMETRY;
+        resetCliInstallIdModuleStateForTests();
+    });
+    afterEach(() => {
+        vi.unstubAllEnvs();
+        if (prevHome === undefined)
+            delete process.env.HOME;
+        else
+            process.env.HOME = prevHome;
+        if (process.platform === "win32") {
+            if (prevUserProfile === undefined)
+                delete process.env.USERPROFILE;
+            else
+                process.env.USERPROFILE = prevUserProfile;
+        }
+        if (prevTelemetry === undefined)
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+        else
+            process.env.AGENTSKEPTIC_TELEMETRY = prevTelemetry;
+        resetCliInstallIdModuleStateForTests();
+    });
+    it("default unset env and no config → disabled", () => {
+        const home = join(tmpdir(), `as-tc-off-${Date.now()}`);
+        mkdirSync(home, { recursive: true });
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            expect(isProductActivationTelemetryEnabled()).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("AGENTSKEPTIC_TELEMETRY=0 → disabled even when config true", () => {
+        const home = join(tmpdir(), `as-tc-env0-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ telemetry: true }), "utf8");
+        try {
+            sandboxHome(home);
+            process.env.AGENTSKEPTIC_TELEMETRY = "0";
+            expect(isProductActivationTelemetryEnabled()).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("AGENTSKEPTIC_TELEMETRY=1 → enabled even when config false", () => {
+        const home = join(tmpdir(), `as-tc-env1-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ telemetry: false }), "utf8");
+        try {
+            sandboxHome(home);
+            process.env.AGENTSKEPTIC_TELEMETRY = "1";
+            expect(isProductActivationTelemetryEnabled()).toBe(true);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("non-1 non-empty env → disabled; config true still applies when env cleared", () => {
+        const home = join(tmpdir(), `as-tc-badenv-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ telemetry: true }), "utf8");
+        try {
+            sandboxHome(home);
+            process.env.AGENTSKEPTIC_TELEMETRY = "yes";
+            expect(isProductActivationTelemetryEnabled()).toBe(false);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            expect(isProductActivationTelemetryEnabled()).toBe(true);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("persisted telemetry true enables when env unset", () => {
+        const home = join(tmpdir(), `as-tc-cfg-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ telemetry: true }), "utf8");
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            expect(isProductActivationTelemetryEnabled()).toBe(true);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("persisted telemetry false disables when env unset", () => {
+        const home = join(tmpdir(), `as-tc-cfgf-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ telemetry: false }), "utf8");
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            expect(isProductActivationTelemetryEnabled()).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("malformed config → readPersistedTelemetryBoolean null; disabled", () => {
+        const home = join(tmpdir(), `as-tc-bad-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), "{ not json", "utf8");
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            expect(readPersistedTelemetryBoolean()).toBe(null);
+            expect(hasPersistedTelemetryPreference()).toBe(false);
+            expect(isProductActivationTelemetryEnabled()).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("telemetry string in config → not a boolean preference", () => {
+        const home = join(tmpdir(), `as-tc-str-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ telemetry: "true" }), "utf8");
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            expect(readPersistedTelemetryBoolean()).toBe(null);
+            expect(hasPersistedTelemetryPreference()).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("tryPersistTelemetryPreference merges unknown keys", () => {
+        const home = join(tmpdir(), `as-tc-merge-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ custom_key: 42, install_id: "00000000-0000-4000-8000-000000000001" }), "utf8");
+        try {
+            sandboxHome(home);
+            expect(tryPersistTelemetryPreference(false)).toBe(true);
+            const disk = JSON.parse(readFileSync(join(home, ".agentskeptic", "config.json"), "utf8"));
+            expect(disk.telemetry).toBe(false);
+            expect(disk.custom_key).toBe(42);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=telemetryConsent.test.js.map

package/dist/telemetry/telemetryConsent.test.js.map

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

package/dist/telemetry/telemetryOfflineConsentPrompt.d.ts

@@ -0,0 +1,15 @@
+export type TelemetryConsentPromptDeps = {
+    /** Test hook: return simulated stdin line (no trailing newline required). */
+    readAnswerLine?: () => Promise<string>;
+};
+/**
+ * After first successful local-sqlite-only OSS verify, optionally prompt once to persist telemetry opt-in/out.
+ * Never throws; failures leave telemetry unchanged (disabled unless already opted in).
+ */
+export declare function maybePromptTelemetryAfterFirstOfflineSuccess(input: {
+    verificationUsedOnlyLocalSqliteFile: boolean;
+    shareReportOriginUsed: boolean;
+    /** Certificate exit would be success (matches_expectations). */
+    verifySucceeded: boolean;
+}, deps?: TelemetryConsentPromptDeps): Promise<void>;
+//# sourceMappingURL=telemetryOfflineConsentPrompt.d.ts.map

package/dist/telemetry/telemetryOfflineConsentPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryOfflineConsentPrompt.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetryOfflineConsentPrompt.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,0BAA0B,GAAG;IACvC,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,4CAA4C,CAChE,KAAK,EAAE;IACL,mCAAmC,EAAE,OAAO,CAAC;IAC7C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,gEAAgE;IAChE,eAAe,EAAE,OAAO,CAAC;CAC1B,EACD,IAAI,GAAE,0BAA+B,GACpC,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/telemetry/telemetryOfflineConsentPrompt.js

@@ -0,0 +1,69 @@
+import { createInterface } from "node:readline";
+import { LICENSE_PREFLIGHT_ENABLED } from "../generated/commercialBuildFlags.js";
+import { hasPersistedTelemetryPreference, isProductActivationTelemetryEnabled, tryPersistTelemetryPreference, } from "./telemetryConsent.js";
+const PROMPT_TEXT = "Verification complete. AgentSkeptic ran offline.\n" +
+    "\n" +
+    "Help improve AgentSkeptic by sending anonymous usage telemetry?\n" +
+    "No workflow data, database contents, credentials, prompts, traces, or verification artifacts are sent.\n" +
+    "You can change this later with AGENTSKEPTIC_TELEMETRY=1 or AGENTSKEPTIC_TELEMETRY=0.\n" +
+    "\n" +
+    "Enable telemetry? (y/N): ";
+/**
+ * After first successful local-sqlite-only OSS verify, optionally prompt once to persist telemetry opt-in/out.
+ * Never throws; failures leave telemetry unchanged (disabled unless already opted in).
+ */
+export async function maybePromptTelemetryAfterFirstOfflineSuccess(input, deps = {}) {
+    if (LICENSE_PREFLIGHT_ENABLED)
+        return;
+    if (!input.verifySucceeded)
+        return;
+    if (!input.verificationUsedOnlyLocalSqliteFile)
+        return;
+    if (input.shareReportOriginUsed)
+        return;
+    if (process.env.AGENTSKEPTIC_TELEMETRY !== undefined)
+        return;
+    if (hasPersistedTelemetryPreference())
+        return;
+    if (isProductActivationTelemetryEnabled())
+        return;
+    if (String(process.env.CI).toLowerCase() === "true")
+        return;
+    if (!process.stdin.isTTY || !process.stderr.isTTY)
+        return;
+    process.stderr.write(PROMPT_TEXT);
+    let line;
+    try {
+        if (deps.readAnswerLine !== undefined) {
+            line = await deps.readAnswerLine();
+        }
+        else {
+            line = await readLineFromStdin();
+        }
+    }
+    catch {
+        return;
+    }
+    const normalized = line.trim().toLowerCase();
+    const yes = normalized === "y" || normalized === "yes";
+    tryPersistTelemetryPreference(yes);
+}
+async function readLineFromStdin() {
+    return await new Promise((resolve, reject) => {
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        rl.once("line", (ln) => {
+            rl.close();
+            resolve(ln ?? "");
+        });
+        rl.once("error", (err) => {
+            try {
+                rl.close();
+            }
+            catch {
+                /* ignore */
+            }
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=telemetryOfflineConsentPrompt.js.map

package/dist/telemetry/telemetryOfflineConsentPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryOfflineConsentPrompt.js","sourceRoot":"","sources":["../../src/telemetry/telemetryOfflineConsentPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EACL,+BAA+B,EAC/B,mCAAmC,EACnC,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,GACf,oDAAoD;IACpD,IAAI;IACJ,mEAAmE;IACnE,0GAA0G;IAC1G,wFAAwF;IACxF,IAAI;IACJ,2BAA2B,CAAC;AAO9B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,4CAA4C,CAChE,KAKC,EACD,OAAmC,EAAE;IAErC,IAAI,yBAAyB;QAAE,OAAO;IACtC,IAAI,CAAC,KAAK,CAAC,eAAe;QAAE,OAAO;IACnC,IAAI,CAAC,KAAK,CAAC,mCAAmC;QAAE,OAAO;IACvD,IAAI,KAAK,CAAC,qBAAqB;QAAE,OAAO;IAExC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,SAAS;QAAE,OAAO;IAE7D,IAAI,+BAA+B,EAAE;QAAE,OAAO;IAC9C,IAAI,mCAAmC,EAAE;QAAE,OAAO;IAElD,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM;QAAE,OAAO;IAC5D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO;IAE1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAElC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC;IACvD,6BAA6B,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnD,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;YACrB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,IAAI,CAAC;gBACH,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/telemetry/telemetryOfflineConsentPrompt.test.d.ts

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

package/dist/telemetry/telemetryOfflineConsentPrompt.test.d.ts.map

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

package/dist/telemetry/telemetryOfflineConsentPrompt.test.js

@@ -0,0 +1,201 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { resetCliInstallIdModuleStateForTests } from "./cliInstallId.js";
+import { resetTelemetryStatusLineForTests } from "./telemetryStatusLine.js";
+import { maybePromptTelemetryAfterFirstOfflineSuccess } from "./telemetryOfflineConsentPrompt.js";
+function sandboxHome(home) {
+    process.env.HOME = home;
+    if (process.platform === "win32") {
+        process.env.USERPROFILE = home;
+    }
+}
+describe("telemetryOfflineConsentPrompt", () => {
+    let prevHome;
+    let prevUserProfile;
+    let prevTelemetry;
+    let prevCi;
+    let prevIsTTYin;
+    let prevIsTTYout;
+    let prevIsTTYerr;
+    beforeEach(() => {
+        prevHome = process.env.HOME;
+        prevUserProfile = process.env.USERPROFILE;
+        prevTelemetry = process.env.AGENTSKEPTIC_TELEMETRY;
+        prevCi = process.env.CI;
+        prevIsTTYin = process.stdin.isTTY;
+        prevIsTTYout = process.stdout.isTTY;
+        prevIsTTYerr = process.stderr.isTTY;
+        resetCliInstallIdModuleStateForTests();
+        resetTelemetryStatusLineForTests();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        Object.defineProperty(process.stdin, "isTTY", { value: prevIsTTYin, configurable: true });
+        Object.defineProperty(process.stdout, "isTTY", { value: prevIsTTYout, configurable: true });
+        Object.defineProperty(process.stderr, "isTTY", { value: prevIsTTYerr, configurable: true });
+        if (prevHome === undefined)
+            delete process.env.HOME;
+        else
+            process.env.HOME = prevHome;
+        if (process.platform === "win32") {
+            if (prevUserProfile === undefined)
+                delete process.env.USERPROFILE;
+            else
+                process.env.USERPROFILE = prevUserProfile;
+        }
+        if (prevTelemetry === undefined)
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+        else
+            process.env.AGENTSKEPTIC_TELEMETRY = prevTelemetry;
+        if (prevCi === undefined)
+            delete process.env.CI;
+        else
+            process.env.CI = prevCi;
+        resetCliInstallIdModuleStateForTests();
+        resetTelemetryStatusLineForTests();
+    });
+    it("CI=true skips prompt and does not write config", async () => {
+        const home = join(tmpdir(), `as-prompt-ci-${Date.now()}`);
+        mkdirSync(home, { recursive: true });
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            process.env.CI = "true";
+            Object.defineProperty(process.stdin, "isTTY", { value: true, configurable: true });
+            Object.defineProperty(process.stderr, "isTTY", { value: true, configurable: true });
+            await maybePromptTelemetryAfterFirstOfflineSuccess({
+                verificationUsedOnlyLocalSqliteFile: true,
+                shareReportOriginUsed: false,
+                verifySucceeded: true,
+            }, { readAnswerLine: async () => "y" });
+            expect(existsSync(join(home, ".agentskeptic", "config.json"))).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("non-interactive stdin skips prompt", async () => {
+        const home = join(tmpdir(), `as-prompt-nitty-${Date.now()}`);
+        mkdirSync(home, { recursive: true });
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            delete process.env.CI;
+            Object.defineProperty(process.stdin, "isTTY", { value: false, configurable: true });
+            Object.defineProperty(process.stderr, "isTTY", { value: true, configurable: true });
+            await maybePromptTelemetryAfterFirstOfflineSuccess({
+                verificationUsedOnlyLocalSqliteFile: true,
+                shareReportOriginUsed: false,
+                verifySucceeded: true,
+            }, { readAnswerLine: async () => "y" });
+            expect(existsSync(join(home, ".agentskeptic", "config.json"))).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("opt-in persists telemetry true", async () => {
+        const home = join(tmpdir(), `as-prompt-y-${Date.now()}`);
+        mkdirSync(home, { recursive: true });
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            delete process.env.CI;
+            Object.defineProperty(process.stdin, "isTTY", { value: true, configurable: true });
+            Object.defineProperty(process.stderr, "isTTY", { value: true, configurable: true });
+            await maybePromptTelemetryAfterFirstOfflineSuccess({
+                verificationUsedOnlyLocalSqliteFile: true,
+                shareReportOriginUsed: false,
+                verifySucceeded: true,
+            }, { readAnswerLine: async () => "yes" });
+            const cfg = JSON.parse(readFileSync(join(home, ".agentskeptic", "config.json"), "utf8"));
+            expect(cfg.telemetry).toBe(true);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("opt-out persists telemetry false", async () => {
+        const home = join(tmpdir(), `as-prompt-n-${Date.now()}`);
+        mkdirSync(home, { recursive: true });
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            delete process.env.CI;
+            Object.defineProperty(process.stdin, "isTTY", { value: true, configurable: true });
+            Object.defineProperty(process.stderr, "isTTY", { value: true, configurable: true });
+            await maybePromptTelemetryAfterFirstOfflineSuccess({
+                verificationUsedOnlyLocalSqliteFile: true,
+                shareReportOriginUsed: false,
+                verifySucceeded: true,
+            }, { readAnswerLine: async () => "n" });
+            const cfg = JSON.parse(readFileSync(join(home, ".agentskeptic", "config.json"), "utf8"));
+            expect(cfg.telemetry).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("skips when shareReportOriginUsed", async () => {
+        const home = join(tmpdir(), `as-prompt-share-${Date.now()}`);
+        mkdirSync(home, { recursive: true });
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            Object.defineProperty(process.stdin, "isTTY", { value: true, configurable: true });
+            Object.defineProperty(process.stderr, "isTTY", { value: true, configurable: true });
+            await maybePromptTelemetryAfterFirstOfflineSuccess({
+                verificationUsedOnlyLocalSqliteFile: true,
+                shareReportOriginUsed: true,
+                verifySucceeded: true,
+            }, { readAnswerLine: async () => "y" });
+            expect(existsSync(join(home, ".agentskeptic", "config.json"))).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("skips when postgres verification path", async () => {
+        const home = join(tmpdir(), `as-prompt-pg-${Date.now()}`);
+        mkdirSync(home, { recursive: true });
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            Object.defineProperty(process.stdin, "isTTY", { value: true, configurable: true });
+            Object.defineProperty(process.stderr, "isTTY", { value: true, configurable: true });
+            await maybePromptTelemetryAfterFirstOfflineSuccess({
+                verificationUsedOnlyLocalSqliteFile: false,
+                shareReportOriginUsed: false,
+                verifySucceeded: true,
+            }, { readAnswerLine: async () => "y" });
+            expect(existsSync(join(home, ".agentskeptic", "config.json"))).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+    it("skips when persisted preference exists", async () => {
+        const home = join(tmpdir(), `as-prompt-exists-${Date.now()}`);
+        mkdirSync(join(home, ".agentskeptic"), { recursive: true });
+        writeFileSync(join(home, ".agentskeptic", "config.json"), JSON.stringify({ telemetry: false }), "utf8");
+        try {
+            sandboxHome(home);
+            delete process.env.AGENTSKEPTIC_TELEMETRY;
+            Object.defineProperty(process.stdin, "isTTY", { value: true, configurable: true });
+            Object.defineProperty(process.stderr, "isTTY", { value: true, configurable: true });
+            await maybePromptTelemetryAfterFirstOfflineSuccess({
+                verificationUsedOnlyLocalSqliteFile: true,
+                shareReportOriginUsed: false,
+                verifySucceeded: true,
+            }, { readAnswerLine: async () => "y" });
+            const cfg = JSON.parse(readFileSync(join(home, ".agentskeptic", "config.json"), "utf8"));
+            expect(cfg.telemetry).toBe(false);
+        }
+        finally {
+            rmSync(home, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=telemetryOfflineConsentPrompt.test.js.map

package/dist/telemetry/telemetryOfflineConsentPrompt.test.js.map

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

package/dist/telemetry/telemetryStatusLine.d.ts

@@ -0,0 +1,12 @@
+/** Exact stderr line when OSS telemetry is off (for tests / contract checks). */
+export declare const OSS_PRODUCT_ACTIVATION_TELEMETRY_STDERR_DISABLED = "Running offline: telemetry disabled.\n";
+/** Exact stderr line when OSS telemetry is on (for tests / contract checks). */
+export declare const OSS_PRODUCT_ACTIVATION_TELEMETRY_STDERR_ENABLED = "Telemetry enabled: sending anonymous usage events.\n";
+/** Vitest / node:test: allow repeated CLI runs in one process. */
+export declare function resetTelemetryStatusLineForTests(): void;
+/**
+ * OSS build: print once whether product-activation telemetry is enabled (stderr).
+ * Does not claim all network is disabled (witnesses, share-report, licensing may still apply).
+ */
+export declare function printProductActivationTelemetryStatusLineOnce(): void;
+//# sourceMappingURL=telemetryStatusLine.d.ts.map

package/dist/telemetry/telemetryStatusLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryStatusLine.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetryStatusLine.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,eAAO,MAAM,gDAAgD,2CAA2C,CAAC;AAEzG,gFAAgF;AAChF,eAAO,MAAM,+CAA+C,yDAAyD,CAAC;AAItH,kEAAkE;AAClE,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,6CAA6C,IAAI,IAAI,CASpE"}

package/dist/telemetry/telemetryStatusLine.js

@@ -0,0 +1,29 @@
+import { LICENSE_PREFLIGHT_ENABLED } from "../generated/commercialBuildFlags.js";
+import { isProductActivationTelemetryEnabled } from "./telemetryConsent.js";
+/** Exact stderr line when OSS telemetry is off (for tests / contract checks). */
+export const OSS_PRODUCT_ACTIVATION_TELEMETRY_STDERR_DISABLED = "Running offline: telemetry disabled.\n";
+/** Exact stderr line when OSS telemetry is on (for tests / contract checks). */
+export const OSS_PRODUCT_ACTIVATION_TELEMETRY_STDERR_ENABLED = "Telemetry enabled: sending anonymous usage events.\n";
+let printed = false;
+/** Vitest / node:test: allow repeated CLI runs in one process. */
+export function resetTelemetryStatusLineForTests() {
+    printed = false;
+}
+/**
+ * OSS build: print once whether product-activation telemetry is enabled (stderr).
+ * Does not claim all network is disabled (witnesses, share-report, licensing may still apply).
+ */
+export function printProductActivationTelemetryStatusLineOnce() {
+    if (printed)
+        return;
+    if (LICENSE_PREFLIGHT_ENABLED)
+        return;
+    printed = true;
+    if (isProductActivationTelemetryEnabled()) {
+        process.stderr.write(OSS_PRODUCT_ACTIVATION_TELEMETRY_STDERR_ENABLED);
+    }
+    else {
+        process.stderr.write(OSS_PRODUCT_ACTIVATION_TELEMETRY_STDERR_DISABLED);
+    }
+}
+//# sourceMappingURL=telemetryStatusLine.js.map

package/dist/telemetry/telemetryStatusLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryStatusLine.js","sourceRoot":"","sources":["../../src/telemetry/telemetryStatusLine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAE5E,iFAAiF;AACjF,MAAM,CAAC,MAAM,gDAAgD,GAAG,wCAAwC,CAAC;AAEzG,gFAAgF;AAChF,MAAM,CAAC,MAAM,+CAA+C,GAAG,sDAAsD,CAAC;AAEtH,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB,kEAAkE;AAClE,MAAM,UAAU,gCAAgC;IAC9C,OAAO,GAAG,KAAK,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6CAA6C;IAC3D,IAAI,OAAO;QAAE,OAAO;IACpB,IAAI,yBAAyB;QAAE,OAAO;IACtC,OAAO,GAAG,IAAI,CAAC;IACf,IAAI,mCAAmC,EAAE,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -555,6 +555,43 @@ export type ActionableFailure = {
 };
 export type EvidenceGapPrimary = "none" | "preview_lane" | "ingest_empty" | "ingest_unstructured" | "registry_unknown_tool" | "registry_resolution" | "database_access" | "timing_or_window" | "witness_unavailable" | "state_mismatch" | "verification_incomplete" | "event_sequence" | "control_flow_context" | "unclassified";
 export type RerunReadiness = "rerun_ready_same_inputs" | "fix_inputs_before_rerun" | "fix_registry_before_rerun" | "reconcile_state_before_rerun" | "manual_review_before_rerun";
+export type AutomationClass = "read_only_retry" | "input_regeneration_candidate" | "human_write_required" | "never_auto_mutate";
+export type RerunPathType = "same_input_verify" | "after_input_fix_verify" | "after_state_fix_verify" | "after_manual_review_verify" | "no_rerun_needed";
+export type RerunPath = {
+    type: RerunPathType;
+    sameInputs: boolean;
+    prerequisite: string;
+    meaningfulWhen: string;
+    readinessLabel: string;
+};
+export type RemediationItemScope = "run_level" | "event_sequence" | "run_context" | "step" | "effect" | "quick_unit" | "quick_ingest";
+export type RemediationItem = {
+    id: string;
+    scope: RemediationItemScope;
+    primary: boolean;
+    failedCheck: string;
+    reasonCodes: string[];
+    reason: string;
+    recommendedAction: RecommendedActionCode;
+    actionText: string;
+    expectedState: {
+        summary: string;
+        projectionKind?: CorrectnessEnforcementKind;
+    };
+    automation: {
+        class: AutomationClass;
+        label: string;
+        boundary: string;
+    };
+    humanReview: {
+        required: boolean;
+        decisionPrompt?: string;
+        hypotheses?: string[];
+        knownFacts?: string[];
+        evidenceToInspect?: string[];
+    };
+    rerunPath: RerunPath;
+};
 export type RemediationNextAction = {
     id: string;
     text: string;
@@ -563,6 +600,8 @@ export type RemediationDecision = {
     actionableFailure: ActionableFailure;
     orderedNextActions: RemediationNextAction[];
     rerunReadiness: RerunReadiness;
+    remediationItems: RemediationItem[];
+    rerunPath: RerunPath;
 };
 export type FailureAnalysisEvidenceItem = {
     scope: "run_context" | "run_level" | "event_sequence" | "step" | "effect";