@supportpages.io/wtfm 0.0.0-stage → 0.3.0

package/dist/sync.js

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+import { stat } from 'node:fs/promises';
+import { remoteArticleSchema, remoteId } from './schema.js';
+import { parse, sha256 } from './artifacts.js';
+import { runSchema } from './runs.js';
+import { fail, publicError } from './errors.js';
+import { Walkthroughs } from './walkthroughs.js';
+import { CLI_NAME } from './brand.js';
+const identity = { id: remoteId, local_article_id: z.uuid().nullable(), title: z.string(), section_id: remoteId.nullable() };
+const generation = z.object({ run_id: z.uuid(), attempt: z.uuid(), state: z.enum(['running', 'failed', 'interrupted', 'cancelled', 'complete', 'kept', 'discarded']) });
+const live = remoteArticleSchema.extend({ ...identity, deleted_at: z.null(), accepted_bundle_hash: z.string().nullable().optional(), generation: generation.nullable().optional() });
+const tombstone = z.object({ ...identity, deleted_at: z.string().min(1) });
+const pageSchema = z.object({ project_id: remoteId, through_id: z.string().regex(/^\d+$/),
+    next_cursor: remoteId.nullable(), articles: z.array(z.union([live, tombstone])).max(500) });
+const stateSchema = z.object({ project_id: remoteId.optional(), api_origin: z.url().optional(), local_article_id: z.uuid(), artifact_dir: z.string(), bundle_dir: z.string(),
+    bundle_hash: z.string(), uploaded_bundle_hash: z.string().optional(), remote: remoteArticleSchema.optional() });
+/** Observed remote state is separate from the revision an upload was based on. */
+export class ProjectSync {
+    bridge;
+    constructor(bridge) {
+        this.bridge = bridge;
+    }
+    async localRecords() {
+        const { ws, stateRoot } = this.bridge, binding = await this.bridge.binding();
+        const archives = [];
+        for (const entry of await ws.list(`${stateRoot}/archives`)) {
+            if (!entry.isDirectory())
+                continue;
+            const root = `${stateRoot}/archives/${entry.name}`;
+            if (!await ws.exists(`${root}/binding.json`))
+                continue;
+            const archived = await ws.json(`${root}/binding.json`);
+            if (archived.project_id === binding.project_id && archived.api_origin === binding.api_origin)
+                archives.push({ root, time: (await stat(await ws.resolve(root))).mtimeMs });
+        }
+        const roots = [stateRoot, ...archives.sort((a, b) => b.time - a.time).map(entry => entry.root)];
+        const result = new Map();
+        // Active records win over history; history is never copied to a new project.
+        for (const root of roots) {
+            const runs = new Map();
+            for (const entry of await ws.list(`${root}/runs`)) {
+                if (!entry.isDirectory() || !z.uuid().safeParse(entry.name).success)
+                    continue;
+                const parsed = runSchema.safeParse(await ws.json(`${root}/runs/${entry.name}/run.json`));
+                if (!parsed.success)
+                    continue;
+                const run = parsed.data;
+                if (run.project_id !== binding.project_id || run.api_origin !== binding.api_origin)
+                    continue;
+                const previous = runs.get(run.local_article_id);
+                if (!previous || run.started_at > previous.started_at)
+                    runs.set(run.local_article_id, run);
+            }
+            const states = new Map();
+            for (const entry of await ws.list(`${root}/articles`)) {
+                if (!entry.isFile() || !entry.name.endsWith('.json'))
+                    continue;
+                const parsed = stateSchema.safeParse(await ws.json(`${root}/articles/${entry.name}`));
+                if (parsed.success && (!parsed.data.project_id || parsed.data.project_id === binding.project_id && parsed.data.api_origin === binding.api_origin))
+                    states.set(parsed.data.local_article_id, parsed.data);
+            }
+            for (const id of new Set([...runs.keys(), ...states.keys()])) {
+                if (result.has(id))
+                    continue;
+                const run = runs.get(id), state = states.get(id);
+                const artifact = run?.artifact_dir ?? state.artifact_dir;
+                let changed = run?.status === 'prepared' || !state || state.bundle_hash !== state.uploaded_bundle_hash;
+                let contentChanged = !state;
+                if (state) {
+                    const bundle = root !== stateRoot && state.bundle_dir.startsWith(`${stateRoot}/`)
+                        ? root + state.bundle_dir.slice(stateRoot.length) : state.bundle_dir;
+                    try {
+                        const manifest = await ws.json(`${bundle}/manifest.json`);
+                        contentChanged = sha256(await ws.read(`${artifact}/article.json`)) !== manifest.article_sha256;
+                        for (const image of manifest.images)
+                            if (sha256(await ws.read(`${artifact}/${image.filename}`, 10 * 1024 * 1024)) !== image.sha256)
+                                contentChanged = true;
+                    }
+                    catch {
+                        contentChanged = true;
+                    }
+                }
+                changed ||= contentChanged;
+                result.set(id, { local_article_id: id, artifact_dir: artifact, run_id: run?.id, title: run?.title,
+                    phase: run?.phase, baseline: run?.remote ?? run?.progress?.article ?? state?.remote, changed, content_changed: contentChanged, bundle_hash: state?.bundle_hash, generation_attempt: run?.progress?.attempt });
+            }
+        }
+        return [...result.values()];
+    }
+    // Caller holds the workspace lock. Commit only a complete, validated inventory.
+    async refresh(context, includeWalkthroughs = true) {
+        const binding = await this.bridge.binding();
+        try {
+            context ??= await this.bridge.context();
+        }
+        catch (error) {
+            if (['not_found', 'permission_denied'].includes(publicError(error).code))
+                fail('project_unavailable', `This help centre is unavailable to the current account. Restore access or run ${CLI_NAME} init to choose a project. The existing link and last sync have been kept.`);
+            throw error;
+        }
+        if (context.project.id !== binding.project_id)
+            fail('destination_mismatch', 'The project changed during sync. Run sync again.');
+        if (!context.article_sync)
+            return { status: 'unsupported', project: context.project,
+                instructions: 'Update the SupportPages.io server to sync article metadata. Existing upload revision checks still apply.' };
+        const remote = [], seen = new Set();
+        let cursor = null, through;
+        for (;;) {
+            const query = cursor ? `?after_id=${cursor}&through_id=${through}` : '';
+            const page = parse(pageSchema, await this.bridge.api.request('GET', `/projects/${binding.project_id}/sync${query}`), 'invalid_response');
+            if (page.project_id !== binding.project_id || through !== undefined && page.through_id !== through)
+                fail('invalid_response', 'The sync response changed project or inventory boundaries.');
+            through = page.through_id;
+            for (const article of page.articles) {
+                if (seen.has(article.id) || BigInt(article.id) <= BigInt(cursor ?? '0') || BigInt(article.id) > BigInt(page.through_id))
+                    fail('invalid_response', 'Invalid article sync page.');
+                seen.add(article.id);
+                remote.push(article);
+            }
+            if (!page.next_cursor)
+                break;
+            if (page.next_cursor !== page.articles.at(-1)?.id || BigInt(page.next_cursor) <= BigInt(cursor ?? '0'))
+                fail('invalid_response', 'Invalid article sync cursor.');
+            cursor = page.next_cursor;
+            if (remote.length > 100_000)
+                fail('inventory_truncated', 'The article inventory is too large to sync. Previous sync records have been kept.');
+        }
+        const locals = await this.localRecords(), matched = new Set();
+        const byId = new Map(remote.map(article => [article.id, article]));
+        const byLocalId = new Map();
+        for (const article of remote)
+            if (article.local_article_id) {
+                if (byLocalId.has(article.local_article_id))
+                    fail('invalid_response', 'Multiple remote articles claim the same local identity.');
+                byLocalId.set(article.local_article_id, article);
+            }
+        const articles = locals.map(local => {
+            const article = local.baseline ? byId.get(local.baseline.id) : byLocalId.get(local.local_article_id);
+            // A record that already links to a remote article by id keeps that link even
+            // when the server remembers a different local identity for it (an earlier
+            // attempt, or a record rewritten by a later run). The local record wins; the
+            // mismatch is reported instead of aborting the whole sync.
+            const identity_mismatch = Boolean(article && article.local_article_id && article.local_article_id !== local.local_article_id);
+            if (article)
+                matched.add(article.id);
+            const available = article && article.deleted_at === null ? article : undefined;
+            const accepted = available?.accepted_bundle_hash && available.accepted_bundle_hash === local.bundle_hash;
+            // A preview still locked to this exact writer can advance after a lost
+            // milestone response. The server forbids editor changes until it is kept.
+            const ownPreview = available?.generation?.run_id === local.run_id && available?.generation?.attempt === local.generation_attempt &&
+                ['running', 'failed', 'interrupted', 'cancelled'].includes(available?.generation?.state ?? '');
+            const changed = available && local.baseline && available.revision !== local.baseline.revision && !accepted && !ownPreview;
+            const sync_status = article?.deleted_at ? 'deleted_remotely' : !article ? local.baseline ? 'unavailable' : 'local_only'
+                : changed ? local.changed ? 'conflict' : 'remote_changed' : local.changed && (!accepted || local.content_changed) ? 'local_changes' : 'synced';
+            return { ...local, remote: article, sync_status, ...(identity_mismatch ? { identity_mismatch } : {}) };
+        });
+        const remoteOnly = remote.filter(article => !matched.has(article.id) && article.deleted_at === null)
+            .map(article => ({ remote: article, sync_status: 'remote_only' }));
+        const previous = await this.bridge.ws.exists(`${this.bridge.stateRoot}/sync.json`)
+            ? await this.bridge.ws.json(`${this.bridge.stateRoot}/sync.json`) : undefined;
+        const walkthroughs = includeWalkthroughs ? await new Walkthroughs(this.bridge).refresh(context, previous?.walkthroughs) : previous?.walkthroughs;
+        const result = { version: 1, status: 'ready', project: context.project, api_origin: binding.api_origin,
+            walkthroughs,
+            synced_at: new Date().toISOString(), product_context: context.product_context, writing_style: context.writing_style,
+            articles: [...articles, ...remoteOnly], counts: { local: locals.length, remote: remote.filter(article => !article.deleted_at).length,
+                conflicts: articles.filter(article => article.sync_status === 'conflict').length,
+                deleted: articles.filter(article => article.sync_status === 'deleted_remotely').length },
+            instructions: 'Remote settings and article metadata are current. Local content is preserved. Review remote edits in the editor before updating an article; never recreate a remotely deleted article automatically.' };
+        await this.bridge.ws.writeJson(`${this.bridge.stateRoot}/sync.json`, result);
+        return result;
+    }
+    async guard(localId, context) {
+        const result = await this.refresh(context, false);
+        if (result.status !== 'ready')
+            return result;
+        const item = result.articles.find(item => 'local_article_id' in item && item.local_article_id === localId);
+        if (!item)
+            return result;
+        const editor_url = item.remote && 'editor_url' in item.remote ? item.remote.editor_url : undefined;
+        if (item.remote && 'generation' in item.remote && item.remote.generation?.state === 'kept')
+            fail('run_closed', 'This preview was kept as an editable draft. Continue in the editor; its writer cannot resume or replace it.', { editor_url });
+        if (item.sync_status === 'deleted_remotely')
+            fail('article_deleted', 'This article was deleted in SupportPages.io. Restore it there before continuing; it will not be recreated automatically.', { editor_url });
+        if (item.sync_status === 'unavailable')
+            fail('article_unavailable', 'The linked article is unavailable. Check its project and access before continuing.');
+        if (['conflict', 'remote_changed'].includes(item.sync_status))
+            fail('revision_conflict', 'This article changed in SupportPages.io. Review the current version in the editor before uploading local changes.', { editor_url });
+        return result;
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/telemetry-scrub.d.ts

@@ -0,0 +1,13 @@
+export type ErrorReport = {
+    error_code: string;
+    error_class: string;
+    message?: string;
+    frames: string[];
+};
+/** Credentials, emails, URLs' paths and queries, and home directories never leave the device. */
+export declare function scrubText(text: string, limit: number): string;
+/** Keeps only the Writer's own frames by location; anything else on the
+ * machine (the user's project, other packages) becomes <external>. */
+export declare function scrubFrame(line: string, installRoot?: string): string;
+/** A report for an unexpected error, or undefined for an expected one. */
+export declare function errorReport(error: unknown, installRoot?: string): ErrorReport | undefined;

package/dist/telemetry-scrub.js

@@ -0,0 +1,51 @@
+import os from 'node:os';
+import { pathToFileURL } from 'node:url';
+import { SupportPagesError } from './errors.js';
+/** Codes that point at a Writer or API bug. Every other SupportPagesError is an
+ * expected account, plan or run state the user recovers from, not a crash. */
+const unexpectedCodes = new Set(['internal_error', 'invalid_response', 'remote_error']);
+const MAX_FRAMES = 30;
+/** Credentials, emails, URLs' paths and queries, and home directories never leave the device. */
+export function scrubText(text, limit) {
+    const home = os.homedir();
+    let value = text.slice(0, limit * 2);
+    if (home.length > 1)
+        value = value.split(home).join('~');
+    return value
+        .replace(/\bsp_(?:local|live)_[A-Za-z0-9]+/g, '[token]')
+        .replace(/\bBearer\s+\S+/gi, 'Bearer [token]')
+        .replace(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi, '[email]')
+        .replace(/(https?:\/\/[^\s/?#]+)[^\s)]*/g, '$1')
+        .replace(/\b[A-Fa-f0-9]{32,}\b/g, '[hex]')
+        .slice(0, limit);
+}
+/** Keeps only the Writer's own frames by location; anything else on the
+ * machine (the user's project, other packages) becomes <external>. */
+export function scrubFrame(line, installRoot) {
+    let frame = line.trim().replace(/^at\s+/, '');
+    if (installRoot) {
+        for (const prefix of [pathToFileURL(installRoot).href, installRoot])
+            frame = frame.split(prefix).join('writer');
+    }
+    frame = frame
+        .replace(/(^|[\s(])(?:file:\/\/)?\/[^\s:()]+/g, '$1<external>')
+        .replace(/(^|[\s(])(?:file:\/\/\/)?[A-Za-z]:[\\/][^\s:()]+/g, '$1<external>');
+    return scrubText(frame, 200);
+}
+/** A report for an unexpected error, or undefined for an expected one. */
+export function errorReport(error, installRoot) {
+    if (error instanceof SupportPagesError && !unexpectedCodes.has(error.code))
+        return undefined;
+    const name = error instanceof Error ? error.constructor.name || error.name : typeof error;
+    const stack = error instanceof Error && typeof error.stack === 'string' ? error.stack : '';
+    const frames = stack.split('\n').filter(line => /^\s+at\s/.test(line)).slice(0, MAX_FRAMES).map(line => scrubFrame(line, installRoot));
+    return {
+        error_code: error instanceof SupportPagesError ? error.code : 'internal_error',
+        error_class: /^[A-Za-z][A-Za-z0-9_.]{0,63}$/.test(name) ? name : 'Error',
+        // Only our own fail() text is sent; a foreign exception's message can quote
+        // file contents, paths or server responses.
+        ...(error instanceof SupportPagesError ? { message: scrubText(error.message, 300) } : {}),
+        frames,
+    };
+}
+//# sourceMappingURL=telemetry-scrub.js.map

package/dist/telemetry-scrub.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,73 @@
+import { type DevicePreferences } from './preferences.js';
+/** Anonymous usage counts and crash reports, on by default and disclosed once.
+ * Sent without credentials to the Writer's own API origin, so nothing ties
+ * them to an account. See docs/writer/client/telemetry.md in the RTFM repo
+ * for the exact fields; nothing else is ever sent. */
+export type TelemetryEvent = 'project_init' | 'article_completed' | 'walkthrough_completed' | 'yolo_started' | 'yolo_completed';
+type Properties = Record<string, string | number | undefined>;
+export declare const telemetryNotice = "SupportPages Writer sends anonymous usage counts and crash reports: no code, file paths, article titles or account details. Ask me to turn this off, or set SUPPORTPAGES_TELEMETRY=0.";
+export type TelemetryReason = 'SUPPORTPAGES_TELEMETRY' | 'DO_NOT_TRACK' | 'CI' | 'preference' | 'default';
+export declare function telemetryStatus(env: NodeJS.ProcessEnv, prefs: DevicePreferences): {
+    enabled: boolean;
+    reason: TelemetryReason;
+};
+export type TelemetryOptions = {
+    configDir: string;
+    origin: string;
+    installRoot?: string;
+    env?: NodeJS.ProcessEnv;
+    fetcher?: typeof fetch;
+    log?: (line: string) => void;
+};
+export declare class Telemetry {
+    private options;
+    private queue;
+    private queued;
+    private errors;
+    private fingerprints;
+    private state?;
+    private chain;
+    private pending;
+    private clientName?;
+    constructor(options: TelemetryOptions);
+    private get env();
+    get endpoint(): string;
+    /** The MCP client's self-reported name, e.g. claude-code or codex. */
+    setClient(name: () => string | undefined): void;
+    /** Creates the install id on first enabled use, which is what counts an install. */
+    private ready;
+    track(event: TelemetryEvent, properties?: Properties): void;
+    /** Reports unexpected errors only; expected account and run states are not bugs. */
+    error(error: unknown, tool?: string): void;
+    private schedule;
+    private flush;
+    /** Counts a new install as soon as the Writer first runs, before any other event. */
+    start(): void;
+    /** Resolves once everything queued so far has been sent or dropped. */
+    drain(): Promise<void>;
+    /** The one-time disclosure, returned the first time it is due and never again. */
+    notice(): Promise<"SupportPages Writer sends anonymous usage counts and crash reports: no code, file paths, article titles or account details. Ask me to turn this off, or set SUPPORTPAGES_TELEMETRY=0." | undefined>;
+    status(): Promise<{
+        sends: string;
+        disable: string;
+        install_id?: string | undefined;
+        endpoint: string;
+        enabled: boolean;
+        reason: TelemetryReason;
+    }>;
+    setEnabled(enabled: boolean): Promise<{
+        message: string;
+        sends: string;
+        disable: string;
+        install_id?: string | undefined;
+        endpoint: string;
+        enabled: boolean;
+        reason: TelemetryReason;
+    }>;
+}
+export declare function configureTelemetry(options: TelemetryOptions | undefined): Telemetry | undefined;
+export declare function activeTelemetry(): Telemetry | undefined;
+export declare function track(event: TelemetryEvent, properties?: Properties): void;
+export declare function reportError(error: unknown, tool?: string): void;
+export declare function secondsSince(start?: string, end?: number): number | undefined;
+export {};

package/dist/telemetry.js

@@ -0,0 +1,173 @@
+import { randomUUID } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { devicePreferences, saveDevicePreferences } from './preferences.js';
+import { errorReport } from './telemetry-scrub.js';
+import { CLI_NAME } from './brand.js';
+export const telemetryNotice = 'SupportPages Writer sends anonymous usage counts and crash reports: no code, file paths, article titles or account details. Ask me to turn this off, or set SUPPORTPAGES_TELEMETRY=0.';
+const disabledWith = /^(0|false|off|no)$/i;
+const MAX_EVENTS = 50;
+const MAX_ERRORS = 10;
+const BATCH = 20;
+const INSTALL_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+export function telemetryStatus(env, prefs) {
+    const setting = env.SUPPORTPAGES_TELEMETRY?.trim();
+    if (setting && disabledWith.test(setting))
+        return { enabled: false, reason: 'SUPPORTPAGES_TELEMETRY' };
+    const doNotTrack = env.DO_NOT_TRACK?.trim();
+    if (doNotTrack && !/^(0|false)$/i.test(doNotTrack))
+        return { enabled: false, reason: 'DO_NOT_TRACK' };
+    // An explicit SUPPORTPAGES_TELEMETRY=1 is the only way to report from CI.
+    if (env.CI && !setting)
+        return { enabled: false, reason: 'CI' };
+    if (prefs.telemetry === false)
+        return { enabled: false, reason: 'preference' };
+    return { enabled: true, reason: prefs.telemetry === true ? 'preference' : 'default' };
+}
+export class Telemetry {
+    options;
+    queue = [];
+    queued = 0;
+    errors = 0;
+    fingerprints = new Set();
+    state;
+    chain = Promise.resolve();
+    pending = false;
+    clientName;
+    constructor(options) {
+        this.options = options;
+    }
+    get env() { return this.options.env ?? process.env; }
+    get endpoint() { return `${this.options.origin}/api/v1/writer_telemetry`; }
+    /** The MCP client's self-reported name, e.g. claude-code or codex. */
+    setClient(name) { this.clientName = name; }
+    /** Creates the install id on first enabled use, which is what counts an install. */
+    ready() {
+        return this.state ??= (async () => {
+            const prefs = await devicePreferences(this.options.configDir);
+            if (!telemetryStatus(this.env, prefs).enabled)
+                return { enabled: false };
+            let installId = typeof prefs.install_id === 'string' && INSTALL_ID.test(prefs.install_id) ? prefs.install_id : undefined;
+            if (!installId) {
+                installId = randomUUID();
+                await saveDevicePreferences(this.options.configDir, { install_id: installId });
+                this.queue.unshift({ event: 'install' });
+            }
+            let version;
+            if (this.options.installRoot) {
+                try {
+                    version = JSON.parse(await readFile(path.join(this.options.installRoot, 'package.json'), 'utf8')).version;
+                }
+                catch { /* Sent without a version. */ }
+            }
+            return { enabled: true, installId, version };
+        })().catch(() => ({ enabled: false }));
+    }
+    track(event, properties = {}) {
+        if (this.queued >= MAX_EVENTS)
+            return;
+        this.queued += 1;
+        // Property values are codes and counts only; anything else (a server
+        // message, a title) is dropped rather than sent.
+        const safe = Object.fromEntries(Object.entries(properties).filter(([, value]) => typeof value === 'number' ? Number.isInteger(value) && value >= 0 : typeof value === 'string' && /^[a-z][a-z0-9_]{0,63}$/.test(value)));
+        this.queue.push({ event, properties: safe });
+        this.schedule();
+    }
+    /** Reports unexpected errors only; expected account and run states are not bugs. */
+    error(error, tool) {
+        try {
+            const report = errorReport(error, this.options.installRoot);
+            if (!report)
+                return;
+            const fingerprint = `${report.error_class}:${report.error_code}:${report.frames[0] ?? ''}`;
+            if (this.errors >= MAX_ERRORS || this.queued >= MAX_EVENTS || this.fingerprints.has(fingerprint))
+                return;
+            this.fingerprints.add(fingerprint);
+            this.errors += 1;
+            this.queued += 1;
+            const { message, frames, ...properties } = report;
+            this.queue.push({ event: 'error', properties: { ...properties, tool: tool && /^[a-z][a-z0-9_]{0,63}$/.test(tool) ? tool : undefined }, error: { message, frames } });
+            this.schedule();
+        }
+        catch { /* Reporting must never add a failure of its own. */ }
+    }
+    schedule() {
+        if (this.pending)
+            return;
+        this.pending = true;
+        this.chain = this.chain.then(async () => {
+            await Promise.resolve();
+            this.pending = false;
+            await this.flush();
+        }).catch(() => { });
+    }
+    async flush() {
+        const state = await this.ready();
+        if (!state.enabled || !state.installId) {
+            this.queue = [];
+            return;
+        }
+        while (this.queue.length) {
+            const events = this.queue.splice(0, BATCH).map(({ event, properties, error }) => ({
+                event, ...(properties ? { properties: Object.fromEntries(Object.entries(properties).filter(([, value]) => value !== undefined)) } : {}), ...(error ? { error } : {}),
+            }));
+            const body = JSON.stringify({ install_id: state.installId, context: {
+                    writer_version: state.version, host_client: this.clientName?.()?.slice(0, 64),
+                    os: process.platform, arch: process.arch, node_major: process.versions.node.split('.')[0],
+                }, events });
+            if (/^(1|true)$/i.test(this.env.SUPPORTPAGES_TELEMETRY_DEBUG ?? ''))
+                (this.options.log ?? (line => process.stderr.write(line)))(`${CLI_NAME} telemetry → ${this.endpoint} ${body}\n`);
+            try {
+                await (this.options.fetcher ?? fetch)(this.endpoint, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body, redirect: 'error', signal: AbortSignal.timeout(3000) });
+            }
+            catch { /* Offline, blocked or an older server: counts are best-effort. */ }
+        }
+    }
+    /** Counts a new install as soon as the Writer first runs, before any other event. */
+    start() { this.schedule(); }
+    /** Resolves once everything queued so far has been sent or dropped. */
+    drain() { return this.chain; }
+    /** The one-time disclosure, returned the first time it is due and never again. */
+    async notice() {
+        try {
+            const prefs = await devicePreferences(this.options.configDir);
+            if (!telemetryStatus(this.env, prefs).enabled || prefs.telemetry_notice_shown)
+                return undefined;
+            await saveDevicePreferences(this.options.configDir, { telemetry_notice_shown: true });
+            return telemetryNotice;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async status() {
+        const prefs = await devicePreferences(this.options.configDir);
+        const status = telemetryStatus(this.env, prefs);
+        return { ...status, endpoint: this.endpoint,
+            ...(typeof prefs.install_id === 'string' ? { install_id: prefs.install_id } : {}),
+            sends: 'Anonymous install id, Writer version, coding client name, OS, CPU architecture, Node.js major version; counts of installs, project setups, finished articles, walkthroughs and whole-help-centre runs (with outcome, location and duration); and error class, code and stack frames for unexpected errors. Never code, file paths, article titles or content, or account details.',
+            disable: `Ask the agent to turn telemetry off (supportpages_set_telemetry), run ${CLI_NAME} telemetry off, or set SUPPORTPAGES_TELEMETRY=0 or DO_NOT_TRACK=1.` };
+    }
+    async setEnabled(enabled) {
+        await saveDevicePreferences(this.options.configDir, { telemetry: enabled, telemetry_notice_shown: true });
+        this.state = undefined;
+        if (!enabled)
+            this.queue = [];
+        const status = await this.status();
+        return { ...status, message: status.enabled === enabled
+                ? `Anonymous usage counts and crash reports are now ${enabled ? 'on' : 'off'} for SupportPages Writer on this device.`
+                : `Saved, but ${status.reason} in the environment keeps telemetry ${status.enabled ? 'on' : 'off'}.` };
+    }
+}
+/** One instance per process, configured by the MCP server or CLI entry point.
+ * Until then (and in library use or tests) every call is a no-op. */
+let active;
+export function configureTelemetry(options) { active = options ? new Telemetry(options) : undefined; return active; }
+export function activeTelemetry() { return active; }
+export function track(event, properties) { active?.track(event, properties); }
+export function reportError(error, tool) { active?.error(error, tool); }
+export function secondsSince(start, end = Date.now()) {
+    const began = start ? Date.parse(start) : NaN;
+    return Number.isFinite(began) && end >= began ? Math.round((end - began) / 1000) : undefined;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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