hacklab 0.22.3 → 26.921.2

package/dist/config.js

@@ -1,93 +0,0 @@
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-const CONFIG_PATH = join(homedir(), '.hacklab', 'config.json');
-/**
- * Resolve the Cursor credentials from the three places a user can set them,
- * highest priority first:
- *
- *   1. `--cursor-api-key` / `--cursor-email`
- *   2. `CURSOR_API_KEY` / `CURSOR_EMAIL` in the environment
- *   3. `~/.hacklab/config.json` (written by `hacklab config cursor-api-key`)
- *
- * (1) and (2) collapse into one check here because index.ts parks the flags in
- * those same env vars before any command runs — the same trick `--env` uses for
- * HACKLAB_APP_URL. A flag therefore beats an inherited env var for free, and
- * `apiKeySource: 'env'` covers both.
- *
- * The email matters as much as the key: it scopes a *team* key to one member.
- * Without it, Cursor's filtered-usage-events endpoint returns every teammate's
- * events and we'd credit the whole team's tokens to one profile.
- */
-export async function resolveCursorAuth() {
-    const config = await loadConfig();
-    const pick = (envName, configValue) => {
-        const envValue = process.env[envName]?.trim();
-        if (envValue)
-            return [envValue, 'env'];
-        if (configValue)
-            return [configValue, 'config'];
-        return [undefined, 'none'];
-    };
-    const [apiKey, apiKeySource] = pick('CURSOR_API_KEY', config.cursorApiKey);
-    const [email, emailSource] = pick('CURSOR_EMAIL', config.cursorEmail);
-    return { apiKey, email, apiKeySource, emailSource };
-}
-export async function loadConfig() {
-    try {
-        const raw = await readFile(CONFIG_PATH, 'utf8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return {};
-    }
-}
-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-sync 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 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/daily-sync.d.ts

@@ -1,150 +0,0 @@
-export type SyncCommand = {
-    node: string;
-    script: string;
-};
-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: ManualSchedule;
-};
-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;
-export declare const SYNC_LOG_MAX_BYTES = 1000000;
-export declare const SYNC_LOG_KEEP_LINES = 200;
-/** Cut an oversized sync.log down to its last few hundred lines. Best-effort,
- * and a no-op while the log is small — which is the normal case. */
-export declare function trimSyncLog(maxBytes?: number, keepLines?: number): Promise<void>;
-/** Append a timestamped line to the background-sync log (best-effort). */
-export declare function appendSyncLog(line: string): Promise<void>;
-/** Record that the background sync can't continue (e.g. the session expired), so
- * the next interactive `hacklab` run can surface it. */
-export declare function markSyncPaused(reason: string): Promise<void>;
-/** The reason the background sync is paused, or null if it isn't. */
-export declare function readSyncPaused(): Promise<string | null>;
-export declare function clearSyncPaused(): Promise<void>;
-/**
- * An absolute path to *this* node that survives the next upgrade of it.
- *
- * `process.execPath` under a package manager is version-scoped:
- * `/opt/homebrew/Cellar/node/26.5.0/bin/node`. `brew upgrade node` relinks
- * `/opt/homebrew/bin/node` to the new keg and moves the shared libraries with
- * it, leaving the old absolute path resolving to a binary that can no longer
- * start ("Library not loaded: …/libada.3.dylib"). A scheduler holding that path
- * dies silently, which is exactly what happened.
- *
- * So: resolve each well-known stable location and take the first that is
- * *literally the same binary* as the one running now — identity by resolved
- * real path, never by version string and never by trusting the symlink blindly.
- * No match (fnm/nvm/asdf shims are per-shell and version-scoped, so they never
- * match) falls back to `process.execPath`, which is what shipped before.
- *
- * It stays an absolute path either way, never a bare `node`: launchd, systemd
- * and Task Scheduler run with almost no PATH, which is the whole reason this
- * function returns a path at all. Don't "simplify" it to `node`.
- */
-export declare function stableNodePath(): string;
-/** 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;
-}, logPath: string): string;
-/** The minutely tick. StartInterval (not a calendar interval) so launchd just
- * re-runs it every 60s; a tick with nothing to report exits without a request. */
-export declare function launchdTickPlist(cmd: SyncCommand, logPath: string): string;
-export declare function systemdService(cmd: SyncCommand): string;
-export declare function systemdTimer(): string;
-export declare function systemdTickService(cmd: SyncCommand): string;
-export declare function systemdTickTimer(): string;
-/** Where the Windows scheduled task's wrapper batch file lives. Next to the
- * session file so it honors HACKLAB_SESSION_PATH, mirroring syncLogPath(). */
-export declare function syncWrapperPath(): string;
-/** The tick's own wrapper — same pattern, its own file so the two tasks can be
- * created and deleted independently. */
-export declare function tickWrapperPath(): string;
-/** The batch wrapper Task Scheduler runs. schtasks' `/TR` chokes on the nested
- * quotes a full `"node" "script" …` command needs, so we point the task at this
- * one-line .cmd instead and do the quoting here, where plain-batch rules apply.
- * Output is redirected to the same sync.log the job also appends to, so a crash
- * before the CLI's own logging still leaves a trace. */
-export declare function schtasksWrapper(cmd: SyncCommand, logPath: string): string;
-/** Same wrapper for the minutely tick, logging to the same sync.log. */
-export declare function schtasksTickWrapper(cmd: SyncCommand, logPath: string): string;
-/** Args for `schtasks /Create`. The `/TR` value is a single pre-quoted path;
- * spawn must run with windowsVerbatimArguments so Node doesn't re-escape it. */
-export declare function schtasksCreateArgs(wrapperPath: string, time: {
-    hour: number;
-    minute: number;
-}): string[];
-/** Args for `schtasks /Create` for the tick: every minute, forever. */
-export declare function schtasksTickCreateArgs(wrapperPath: string): string[];
-/** Two jobs the user must schedule by hand, each with the cadence it needs and
- * the full absolute command to run — the paths are long because a scheduler's
- * bare PATH can't find `node` or `hacklab` on its own. */
-export type ManualSchedule = {
-    cadence: string;
-    command: string;
-}[];
-export declare function manualInstructions(cmd: SyncCommand): ManualSchedule;
-/** Render a ManualSchedule as ready-to-print lines: a dim explainer, then each
- * job as a dim cadence label above its bold, copy-pasteable command. Blank
- * lines separate the two commands so neither reads as a wrapped continuation of
- * the other. */
-export declare function formatManualSchedule(schedule: ManualSchedule): string[];
-/**
- * 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 +0,0 @@
-{"version":3,"file":"daily-sync.d.ts","sourceRoot":"","sources":["../src/daily-sync.ts"],"names":[],"mappings":"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"}