hacklab 0.13.1 → 0.14.0

package/dist/commands/setup.js

@@ -0,0 +1,265 @@
+import * as clack from '@clack/prompts';
+import { dailySyncState, installDailySync } from '../daily-sync.js';
+import { captureEvent, identifyUser } from '../posthog.js';
+import { loadPromptConsent, savePromptConsent, } from '../prompt-consent.js';
+import { rebuildScanState } from '../scanners/incremental.js';
+import { collectToolScans, mergeToolScans, } from '../scanners/index.js';
+import { loadSession, resolveAppUrl, saveSession, } from '../session.js';
+import { scanConsentedPromptStats, uploadTokenScan } from '../sync.js';
+import { bold, dim, error, info, success } from '../ui.js';
+import { ensureHandleClaimed, performLogin } from './login.js';
+import { formatScanReceipt } from './scan.js';
+/**
+ * `hacklab setup` — the front door.
+ *
+ *   scan → anonymous rank → GitHub auth → one consent question → upload → daemon
+ *
+ * The one deliberate composite command in the CLI (DESIGN.md's "one job per
+ * command" carries a recorded exception for it): face-to-face testing showed
+ * that install → `login` → `scan` reads as three unrelated chores to someone who
+ * has never used hacklab, and people stalled between them. Each stage still
+ * degrades on its own terms, and every piece remains its own command for anyone
+ * who wants to re-run just that piece.
+ */
+export async function setup() {
+    clack.intro(bold('Hacklab CLI setup'));
+    console.log(dim('scans your AI usage, connects GitHub, and starts a background usage sync'));
+    console.log('');
+    const existing = await loadSession();
+    const appUrl = resolveAppUrl(existing);
+    const syncState = await dailySyncState();
+    // ── Already set up ───────────────────────────────────────────────────────
+    // A finished account AND a live daemon means there is genuinely nothing to
+    // do. Anything less falls through and skips only the stages already done.
+    if (existing?.handle && existing.usernameClaimed && syncState === 'current') {
+        console.log(`already set up — you're ${bold(`@${existing.handle}`)}`);
+        console.log(dim('re-scan with `hacklab scan`, re-upload with `hacklab sync`'));
+        clack.outro(dim(`${appUrl}/${existing.handle}`));
+        return;
+    }
+    // ── Scan (before auth — an anonymous scan needs no account) ──────────────
+    const spin = clack.spinner();
+    spin.start('scanning local AI tool usage');
+    let results;
+    try {
+        results = await collectToolScans();
+    }
+    catch (err) {
+        spin.stop('scan failed');
+        clack.cancel(`couldn't read local AI usage: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    spin.stop('scan complete');
+    const scan = mergeToolScans(results);
+    if (scan.grandTotal > 0) {
+        console.log('');
+        for (const line of formatScanReceipt(scan))
+            console.log(line);
+        console.log('');
+    }
+    else {
+        // No hard floor: a hackathon-door signup on a fresh laptop is exactly who
+        // this flow is for, so the default is yes.
+        const cont = await clack.confirm({
+            message: 'No AI usage found on this machine. Set up your account anyway?',
+            initialValue: true,
+        });
+        if (clack.isCancel(cont) || !cont) {
+            clack.outro(dim('come back after some Claude Code / Codex / Cursor sessions.'));
+            return;
+        }
+    }
+    // ── Anonymous rank preview (a hook, never a gate) ────────────────────────
+    let previewRank;
+    if (scan.grandTotal > 0) {
+        const preview = await fetchRankPreview(appUrl, scan.grandTotal);
+        if (preview) {
+            previewRank = preview.rank;
+            console.log(`${bold(`you'd be #${preview.rank}`)} of ${preview.ofTotal} hackers`);
+            console.log('');
+        }
+    }
+    // ── GitHub auth (the exact device flow `hacklab login` runs) ─────────────
+    let session;
+    let claimFailed;
+    if (existing) {
+        // Reuse a session that's already on disk. It may still be half-finished
+        // (auth succeeded, the claim didn't), so run the claim guard over it.
+        const outcome = await ensureHandleClaimed(existing, 2);
+        if (outcome.session !== existing)
+            await saveSession(outcome.session);
+        session = outcome.session;
+        claimFailed = outcome.claimFailed;
+        console.log(session.handle
+            ? `signed in as @${session.handle}`
+            : `signed in as ${session.email}`);
+        console.log('');
+    }
+    else {
+        try {
+            const outcome = await performLogin({ claimAttempts: 2 });
+            session = outcome.session;
+            claimFailed = outcome.claimFailed;
+        }
+        catch (err) {
+            clack.cancel(`GitHub sign-in failed: ${err instanceof Error ? err.message : String(err)}. run \`hacklab setup\` again.`);
+            process.exit(1);
+        }
+        console.log('');
+        console.log(session.handle
+            ? `signed in as @${session.handle}`
+            : `signed in as ${session.email}`);
+        console.log('');
+    }
+    // A lost claim must never be silent here: the web onboarding page polls
+    // `username_claimed` and would sit spinning forever.
+    if (claimFailed) {
+        error("couldn't finish claiming your handle");
+        info(dim('run `hacklab login` again to finish it'));
+        console.log('');
+    }
+    // ── The one question in the flow ─────────────────────────────────────────
+    const consent = await askConversationConsent();
+    // ── Upload ───────────────────────────────────────────────────────────────
+    spin.start('saving your usage');
+    let rank;
+    try {
+        const promptStats = await scanConsentedPromptStats(consent);
+        const uploaded = await uploadTokenScan(session, scan, {
+            interactive: true,
+            timeoutMs: 120_000,
+            promptStats,
+        });
+        // A full scan just went out, so re-base the minutely tick's incremental
+        // state on it — otherwise the first tick re-uploads the whole history.
+        await rebuildScanState(results);
+        spin.stop('usage saved');
+        const after = uploaded.rankAfter;
+        if (typeof after === 'number' && Number.isFinite(after))
+            rank = after;
+        if (rank)
+            console.log(`rank: #${rank}`);
+    }
+    catch {
+        // Never fatal — the account exists, and `hacklab sync` is the recovery.
+        spin.stop('usage sync deferred');
+        console.log(dim('run `hacklab sync` later to upload it'));
+    }
+    // ── Daemon (silent; the intro line is the whole disclosure) ──────────────
+    await installDaemon(syncState, session.handle);
+    // ── Tail ─────────────────────────────────────────────────────────────────
+    console.log('');
+    success(session.handle ? `you're in — ${appUrl}/${session.handle}` : "you're in");
+    clack.outro(dim('head back to your browser — the page will move on by itself'));
+    if (session.handle) {
+        await identifyUser(session.handle, {
+            $set: {
+                email: session.email,
+                handle: session.handle,
+                app_url: appUrl,
+            },
+            $set_once: { joined_at: new Date().toISOString() },
+        });
+        await captureEvent(session.handle, 'cli_setup_completed', {
+            tokens_total: scan.grandTotal,
+            ...((rank ?? previewRank) ? { rank: rank ?? previewRank } : {}),
+            prompt_consent: consent,
+        });
+    }
+}
+/**
+ * Ask once whether to share conversation text, defaulting to yes.
+ *
+ * Deliberately NOT prompt-consent.ts's `askYesNo` (which refuses to carry a
+ * default): setup is the one place a default-yes is the product decision, and
+ * `clack.confirm` with `initialValue: true` still requires the user to accept it
+ * — a keypress they perform, not a value applied behind their back. `sync`'s
+ * no-default disclosure is untouched. A non-TTY run has nobody to accept, so it
+ * stays at 'none'.
+ */
+async function askConversationConsent() {
+    const stored = await loadPromptConsent();
+    if (stored) {
+        console.log(dim(`conversation sharing: ${stored} — change with \`hacklab config prompt-stats <full|stats|none>\``));
+        console.log('');
+        return stored;
+    }
+    if (!process.stdin.isTTY)
+        return 'none';
+    console.log(bold('share your prompts?'));
+    console.log('hacklab scores how well you work with AI. your real prompts give the');
+    console.log('scoring model actual evidence — a sharper score, and a profile that');
+    console.log('stands out. a sample of up to 20,000 characters is read by the model,');
+    console.log('scored, and discarded. never stored, never shown to anyone.');
+    console.log(dim('change anytime: hacklab config prompt-stats <full|stats|none>'));
+    console.log('');
+    const answer = await clack.confirm({
+        message: 'share a sample of your prompts?',
+        initialValue: true,
+    });
+    // Only the two tiers that were actually asked about. 'stats' (numbers, no
+    // text) was never on the table here; it stays reachable via `hacklab config`.
+    const tier = !clack.isCancel(answer) && answer === true ? 'full' : 'none';
+    await savePromptConsent(tier);
+    return tier;
+}
+/** The anonymous "you'd be #N of M" call. Any failure is skipped in silence. */
+async function fetchRankPreview(appUrl, totalTokens) {
+    try {
+        const res = await fetch(`${appUrl}/api/rank/preview`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ totalTokens }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        if (typeof data.rank !== 'number' || typeof data.ofTotal !== 'number') {
+            return null;
+        }
+        return { rank: data.rank, ofTotal: data.ofTotal };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Arm the background sync without asking — the intro line already disclosed it.
+ * Same install-once / repair-'stale' rules `scan` uses: a reinstall rewrites the
+ * plists/units and bounces the jobs, so only touch the scheduler when something
+ * is actually wrong, and only announce a genuinely fresh install.
+ */
+async function installDaemon(state, handle) {
+    if (state === 'current')
+        return;
+    const result = await installDailySync();
+    if (!result.ok) {
+        // A failed *repair* means the jobs are still scheduled — printing cron
+        // instructions there talks the user into a second, duplicate schedule.
+        if (state === 'missing') {
+            console.log(dim(result.instructions));
+            if (handle) {
+                await captureEvent(handle, 'cli_daily_sync_manual', {
+                    mechanism: result.mechanism,
+                    source: 'setup',
+                });
+            }
+        }
+        return;
+    }
+    if (!result.recorded) {
+        console.log(dim('could not record daily-sync state — config unwritable'));
+        return;
+    }
+    if (state === 'missing') {
+        console.log(dim(`background sync scheduled (${result.mechanism})`));
+        if (handle) {
+            await captureEvent(handle, 'cli_daily_sync_installed', {
+                mechanism: result.mechanism,
+                source: 'setup',
+            });
+        }
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/config.d.ts

@@ -1,6 +1,24 @@
+/**
+ * What the OS-native background jobs were last installed with — written by
+ * daily-sync.ts on a successful install, cleared on uninstall. `command`
+ * fingerprints the scheduled `node <script>` pair plus the template generation
+ * that produced the jobs, so a routine run can tell a working schedule from one
+ * worth replacing; hour/minute pin the daily slot so a reinstall doesn't re-roll
+ * it. Opaque here: daily-sync.ts owns the format.
+ */
+export type DailySyncRecord = {
+    command: string;
+    hour?: number;
+    minute?: number;
+    /** False when the scheduler accepted the daily job but refused the minutely
+     * tick (a Windows policy cap), so a later run doesn't read that machine as a
+     * half-install and reinstall on every scan. */
+    tick?: boolean;
+};
 export type HacklabConfig = {
     cursorApiKey?: string;
     cursorEmail?: string;
+    dailySync?: DailySyncRecord;
     /**
      * Consent for uploading Claude Code conversation data: 'none' | 'stats' |
      * 'full'. Absent means never asked — see prompt-consent.ts, which owns the
@@ -36,4 +54,18 @@ export type CursorAuth = {
 export declare function resolveCursorAuth(): Promise<CursorAuth>;
 export declare function loadConfig(): Promise<HacklabConfig>;
 export declare function saveConfig(config: HacklabConfig): Promise<void>;
+/**
+ * Read-modify-write the config file for background callers that must not lose
+ * the rest of it. Unlike `loadConfig`, which flattens every read failure to
+ * `{}`, this refuses to write when the file exists but can't be parsed —
+ * spreading `{}` over an unreadable config would silently drop the user's cursor
+ * key and prompt-stats consent, and nothing here is worth that.
+ *
+ * `mutate` returns the config to write, or null for "nothing to change" (no
+ * write at all — a background job shouldn't rewrite config.json for nothing).
+ * Never throws: resolves true when the config reflects the mutation, false when
+ * the write was refused or failed, so the caller can react to not being
+ * remembered.
+ */
+export declare function updateConfig(mutate: (config: HacklabConfig) => HacklabConfig | null): Promise<boolean>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAID,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,gBAAgB,CAAA;IAC9B,WAAW,EAAE,gBAAgB,CAAA;CAC9B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CAgB7D;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAOzD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;mDAE+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAID,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAExD,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,gBAAgB,CAAA;IAC9B,WAAW,EAAE,gBAAgB,CAAA;CAC9B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CAgB7D;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAOzD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,GAAG,IAAI,GACtD,OAAO,CAAC,OAAO,CAAC,CA6BlB"}

package/dist/config.js

@@ -46,4 +46,48 @@ export async function saveConfig(config) {
     await mkdir(dirname(CONFIG_PATH), { recursive: true });
     await writeFile(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
 }
+/**
+ * Read-modify-write the config file for background callers that must not lose
+ * the rest of it. Unlike `loadConfig`, which flattens every read failure to
+ * `{}`, this refuses to write when the file exists but can't be parsed —
+ * spreading `{}` over an unreadable config would silently drop the user's cursor
+ * key and prompt-stats consent, and nothing here is worth that.
+ *
+ * `mutate` returns the config to write, or null for "nothing to change" (no
+ * write at all — a background job shouldn't rewrite config.json for nothing).
+ * Never throws: resolves true when the config reflects the mutation, false when
+ * the write was refused or failed, so the caller can react to not being
+ * remembered.
+ */
+export async function updateConfig(mutate) {
+    let current = {};
+    try {
+        const parsed = JSON.parse(await readFile(CONFIG_PATH, 'utf8'));
+        // A file that parses to a non-object (`null`, an array, a bare string) is
+        // just as unreadable as one that doesn't parse: refuse it too.
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            return false;
+        }
+        current = parsed;
+    }
+    catch (err) {
+        // No config yet is the normal first-run case; anything else means there IS
+        // content we can't see, so leave it alone.
+        if (err?.code !== 'ENOENT')
+            return false;
+    }
+    const next = mutate(current);
+    if (!next)
+        return true;
+    try {
+        await saveConfig(next);
+        return true;
+    }
+    catch {
+        // Read-only home, no permission, disk full — the caller decides what to say.
+        return false;
+    }
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAazC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;AAY9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAA;IACjC,MAAM,IAAI,GAAG,CACX,OAAe,EACf,WAA+B,EACS,EAAE;QAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAA;QAC7C,IAAI,QAAQ;YAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QACtC,IAAI,WAAW;YAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAC/C,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;IAC1E,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;IAErE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,CAAA;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAA;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAqB;IACpD,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACtD,MAAM,SAAS,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAC9E,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/daily-sync.d.ts

@@ -2,15 +2,27 @@ export type SyncCommand = {
     node: string;
     script: string;
 };
-export type InstallResult = {
-    ok: true;
+type ScheduledJobs = {
     mechanism: 'launchd' | 'systemd' | 'schtasks';
     detail: string;
-} | {
+    /** Whether the minutely tick job registered too. Only the schtasks path can
+     * come back false: some Windows policies cap task frequency, and a refused
+     * tick costs freshness, not the streak — so we keep the daily job and
+     * remember not to expect a tick task that will never exist. */
+    tick: boolean;
+};
+type InstallFailure = {
     ok: false;
     mechanism: 'manual' | 'unsupported';
     instructions: string;
 };
+export type InstallResult = ({
+    ok: true;
+    /** Whether we managed to remember this install (see updateConfig). False
+     * means the next run can't tell the schedule is current and will reinstall
+     * — worth saying out loud rather than churning in silence. */
+    recorded: boolean;
+} & ScheduledJobs) | InstallFailure;
 /** The daily background job writes here; launchd/systemd also point stdout+stderr
  * at it. Lives next to the session file so it honors HACKLAB_SESSION_PATH. */
 export declare function syncLogPath(): string;
@@ -30,6 +42,10 @@ export declare function clearSyncPaused(): Promise<void>;
 /** Absolute `node` + the CLI's own entry script, so the scheduler doesn't depend
  * on a `hacklab` bin being on its PATH. */
 export declare function resolveSyncCommand(): SyncCommand;
+/** Identity of what the jobs were installed with: the command they run plus the
+ * template generation that produced them. Stored after a successful install so a
+ * later run can tell an up-to-date schedule from one worth replacing. */
+export declare function syncCommandFingerprint(cmd: SyncCommand): string;
 export declare function launchdPlist(cmd: SyncCommand, time: {
     hour: number;
     minute: number;
@@ -64,11 +80,38 @@ export declare function schtasksCreateArgs(wrapperPath: string, time: {
 /** Args for `schtasks /Create` for the tick: every minute, forever. */
 export declare function schtasksTickCreateArgs(wrapperPath: string): string[];
 export declare function manualInstructions(cmd: SyncCommand): string;
-/** True when the OS scheduler already has the daily job. */
-export declare function dailySyncInstalled(): Promise<boolean>;
+/**
+ * True when the OS scheduler has the background jobs. A half-install (say a
+ * plist that got deleted) reads as not installed, so the next run repairs it.
+ *
+ * `expectTick: false` drops the tick from that expectation, for the one machine
+ * that legitimately has none: a Windows box whose policy refused the minutely
+ * task. Without it such a box would read as half-installed forever and reinstall
+ * on every scan. Callers that don't know either way get the strict check.
+ */
+export declare function dailySyncInstalled({ expectTick, }?: {
+    expectTick?: boolean;
+}): Promise<boolean>;
+/**
+ * What a routine run (e.g. `scan`) should do about the background jobs:
+ *
+ *   'missing' — no jobs, or only half of them: install, and say so.
+ *   'stale'   — jobs exist but what they run is broken or unknown: reinstall
+ *               quietly.
+ *   'current' — jobs exist and still work: do nothing.
+ *
+ * "Still work" is deliberately weaker than "match what this process would
+ * install": someone alternating node versions or checkouts flips the fingerprint
+ * on every run while both schedules remain perfectly runnable, and rebuilding
+ * the jobs each way round would be a permanent ping-pong. Only a command that
+ * has actually gone missing (or a record we can't read, which includes installs
+ * predating the fingerprint) earns a reinstall.
+ */
+export declare function dailySyncState(): Promise<'missing' | 'stale' | 'current'>;
 /** Install (or refresh) both background jobs (tick + daily) for the current OS. */
 export declare function installDailySync(): Promise<InstallResult>;
 /** Remove both background jobs. Best-effort and never throws, so it's safe to
  * call from `logout` whether or not they were ever installed. */
 export declare function uninstallDailySync(): Promise<void>;
+export {};
 //# sourceMappingURL=daily-sync.d.ts.map

package/dist/daily-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daily-sync.d.ts","sourceRoot":"","sources":["../src/daily-sync.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,QAAQ,GAAG,aAAa,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAgB5E;8EAC8E;AAC9E,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAQD,eAAO,MAAM,kBAAkB,UAAY,CAAA;AAC3C,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC;oEACoE;AACpE,wBAAsB,WAAW,CAC/B,QAAQ,SAAqB,EAC7B,SAAS,SAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,0EAA0E;AAC1E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D;AAED;wDACwD;AACxD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlE;AAED,qEAAqE;AACrE,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO7D;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD;AAED;2CAC2C;AAC3C,wBAAgB,kBAAkB,IAAI,WAAW,CAShD;AAyCD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACtC,OAAO,EAAE,MAAM,GACd,MAAM,CAcR;AAED;kFACkF;AAClF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS1E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASvD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAcrC;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAQ3D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAgBzC;AAED;8EAC8E;AAC9E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;wCACwC;AACxC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;wDAIwD;AACxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;gFACgF;AAChF,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,EAAE,CAaV;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAapE;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAS3D;AAiID,4DAA4D;AAC5D,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAoB3D;AAED,mFAAmF;AACnF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAwB/D;AAED;iEACiE;AACjE,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BxD"}
+{"version":3,"file":"daily-sync.d.ts","sourceRoot":"","sources":["../src/daily-sync.ts"],"names":[],"mappings":"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"}