hacklab 0.18.0 → 0.20.0

package/dist/prompt-consent.js

@@ -1,67 +1,81 @@
 import { createInterface } from 'node:readline';
-import { loadConfig, saveConfig } from './config.js';
+import { loadConfig, updateConfig } from './config.js';
 import { bold, dim, info } from './ui.js';
 /**
- * Consent for uploading anything derived from the user's Claude Code
+ * Consent for syncing anything derived from the user's Claude Code
  * conversations.
  *
  * Nothing conversation-derived leaves the machine until someone has answered
  * this explicitly. The tiers are additive:
  *
- *   none   token counts only — exactly what the CLI did before this existed
- *   stats  + prompt-length histogram and per-project prompt counts (numbers
- *          only; no prompt text ever leaves the machine)
- *   full   + a sample of the raw prompt text, so the backend can score how
- *          technical the prompting is. It scores the sample and discards it.
+ *   none   token counts only — nothing prompt-related leaves the machine
+ *   stats  + continuous prompt metadata: counts, word counts, timestamps and
+ *          session ids, synced every minute alongside tokens, so the profile
+ *          can show sessions, concurrent sessions and prompt counts. Prompt
+ *          text never leaves the machine.
+ *   full   + a rolling sample of the most recent prompts (up to 20,000
+ *          characters) sent with the daily sync, used only to estimate a
+ *          technical-level score and then discarded. Never stored.
  *
- * The answer is remembered in ~/.hacklab/config.json so the question is asked
- * once, and can be changed or revoked at any time with
- * `hacklab config prompt-stats <tier>`.
+ * The answer is remembered in ~/.hacklab/config.json under `promptSync` so the
+ * question is asked once, and can be changed or revoked at any time with
+ * `hacklab config prompt-sync <tier>`.
  */
-export const PROMPT_CONSENT_TIERS = ['none', 'stats', 'full'];
-export function isPromptConsentTier(value) {
+export const PROMPT_SYNC_TIERS = ['none', 'stats', 'full'];
+export function isPromptSyncTier(value) {
     return (typeof value === 'string' &&
-        PROMPT_CONSENT_TIERS.includes(value));
+        PROMPT_SYNC_TIERS.includes(value));
 }
-/** The stored answer, or null when the user has never been asked. */
-export async function loadPromptConsent() {
+/**
+ * The stored answer, or null when the user has never been asked *this*
+ * question. The pre-continuous-sync key (`promptStatsConsent`) is deliberately
+ * not read: it answered a different question — a one-off scan, not a minutely
+ * sync of session metadata — so it can't stand in for this one.
+ */
+export async function loadPromptSync() {
     const config = await loadConfig();
-    return isPromptConsentTier(config.promptStatsConsent)
-        ? config.promptStatsConsent
-        : null;
+    return isPromptSyncTier(config.promptSync) ? config.promptSync : null;
 }
-export async function savePromptConsent(tier) {
-    const config = await loadConfig();
-    config.promptStatsConsent = tier;
-    await saveConfig(config);
+/**
+ * Remember the answer. Read-modify-write via `updateConfig` rather than a bare
+ * `saveConfig`, because the background jobs call this too and must never
+ * flatten a config file they couldn't read. The obsolete key goes with it, so
+ * a machine is never carrying two answers to two different questions.
+ */
+export async function savePromptSync(tier) {
+    await updateConfig((config) => {
+        config.promptSync = tier;
+        delete config.promptStatsConsent;
+        return config;
+    });
 }
 /**
- * Read `--share-prompt-stats[=<tier>]` out of a command's args.
+ * Read `--share-prompt-sync[=<tier>]` out of a command's args.
  *
  * This is the agent-friendly path: it answers the question up front so an
  * unattended run never blocks on a prompt it can't see. Bare
- * `--share-prompt-stats` means the numbers-only tier — the safe reading of an
+ * `--share-prompt-sync` means the metadata-only tier — the safe reading of an
  * unqualified yes, since sending prompt *text* should always be deliberate.
- * `--no-share-prompt-stats` is an explicit refusal.
+ * `--no-share-prompt-sync` is an explicit refusal.
  *
  * Returns the chosen tier, or null when the flag is absent. `rest` is the args
  * with the flag removed so per-command parsing never sees it.
  */
-export function parsePromptStatsFlag(args) {
+export function parsePromptSyncFlag(args) {
     const rest = [];
     let tier = null;
     for (const arg of args) {
-        if (arg === '--no-share-prompt-stats') {
+        if (arg === '--no-share-prompt-sync') {
             tier = 'none';
             continue;
         }
-        if (arg === '--share-prompt-stats') {
+        if (arg === '--share-prompt-sync') {
             tier = 'stats';
             continue;
         }
-        if (arg.startsWith('--share-prompt-stats=')) {
-            const value = arg.slice('--share-prompt-stats='.length);
-            tier = isPromptConsentTier(value) ? value : 'stats';
+        if (arg.startsWith('--share-prompt-sync=')) {
+            const value = arg.slice('--share-prompt-sync='.length);
+            tier = isPromptSyncTier(value) ? value : 'stats';
             continue;
         }
         rest.push(arg);
@@ -106,62 +120,65 @@ export async function askYesNo(question) {
 /** The disclosure. Printed verbatim before the first question. */
 function printDisclosure() {
     console.log('');
-    console.log(bold('  share prompt stats?'));
+    console.log(bold('  sync your prompt activity?'));
     console.log('');
-    info('  hacklab can read your local Claude Code history to chart how you prompt.');
-    info(`  it is read on this machine, from ${dim('~/.claude/projects')}.`);
+    info('  hacklab can keep your profile up to date with how you work with AI,');
+    info(`  reading your Claude Code history from ${dim('~/.claude/projects')}.`);
     console.log('');
-    info(`  ${bold('what would be uploaded')}`);
-    info('    how many prompts you have sent, and how long they are in words');
-    info('    a prompt count per project, matched by its git remote');
+    info(`  ${bold('what would be synced, every minute:')}`);
+    info(`    ${dim('-')} how many prompts you send, and how long they are in words`);
+    info(`    ${dim('-')} when each session started and last ran, and its session id`);
+    info(`    ${dim('-')} a prompt count per project, matched by its git remote`);
     console.log('');
-    info(`  ${bold('what would not')}`);
-    info('    the text of your prompts, unless you separately say yes below');
-    info('    anything from a project without a git remote');
+    info(`  ${bold('what stays on this machine:')}`);
+    info(`    ${dim('-')} the text of your prompts, unless you separately say yes below`);
+    info(`    ${dim('-')} anything from a project without a git remote`);
     console.log('');
-    info(dim('  hacklab stores the numbers on your profile. you can change or revoke'));
-    info(dim('  this later with `hacklab config prompt-stats <none|stats|full>`.'));
+    info(dim('  your profile shows your sessions, how many you run at once, and'));
+    info(dim('  your prompt counts. change or revoke this any time with'));
+    info(dim('  `hacklab config prompt-sync <none|stats|full>`.'));
     console.log('');
 }
 /**
- * Resolve the consent tier for this run.
+ * Resolve the prompt-sync tier for this run.
  *
  * Precedence: an explicit flag wins (and is remembered), then the stored
  * answer, then the interactive questions. An unattended run that has never
  * answered gets `none` — silence is never consent.
  */
-export async function resolvePromptConsent(flagTier, opts = {}) {
+export async function resolvePromptSync(flagTier, opts = {}) {
     if (flagTier) {
-        await savePromptConsent(flagTier);
+        await savePromptSync(flagTier);
         return flagTier;
     }
-    const stored = await loadPromptConsent();
+    const stored = await loadPromptSync();
     if (stored)
         return stored;
     if (!opts.interactive || !process.stdin.isTTY)
         return 'none';
     printDisclosure();
-    const shareNumbers = await askYesNo('  share these numbers with hacklab?');
-    if (shareNumbers === null)
+    const shareActivity = await askYesNo('  sync this to hacklab?');
+    if (shareActivity === null)
         return 'none';
-    if (!shareNumbers) {
-        await savePromptConsent('none');
+    if (!shareActivity) {
+        await savePromptSync('none');
         console.log('');
-        info(dim('  no problem — syncing token counts only, as before.'));
+        info(dim('  no problem — syncing token counts only.'));
         return 'none';
     }
     console.log('');
-    info('  optional: a sample of your prompt text (up to 20k characters) can be');
-    info('  sent so an LLM can score how technical your prompting is. hacklab');
-    info(`  scores it and ${bold('discards it')} — the text is never stored.`);
+    info('  optional: a rolling sample of your most recent prompts (up to 20,000');
+    info('  characters) can go out with the daily sync, so a model can estimate');
+    info(`  how technical your prompting is. hacklab scores it and ${bold('discards it')} —`);
+    info('  the text is never stored.');
     console.log('');
-    const shareText = await askYesNo('  also send a sample of your prompt text?');
+    const shareText = await askYesNo('  also send a sample of your most recent prompts?');
     const tier = shareText === true ? 'full' : 'stats';
-    await savePromptConsent(tier);
+    await savePromptSync(tier);
     console.log('');
     info(dim(tier === 'full'
-        ? '  sharing prompt stats and a text sample.'
-        : '  sharing prompt stats. numbers only, no text.'));
+        ? '  syncing prompt activity and a text sample.'
+        : '  syncing prompt activity. numbers only, no text.'));
     return tier;
 }
 //# sourceMappingURL=prompt-consent.js.map

package/dist/prompt-consent.js.map

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

package/dist/prompt-stats.d.ts

@@ -1,8 +1,10 @@
 /** Buckets are `1..bucketMax`, so the axis stays readable at any prompt length. */
 export declare const PROMPT_LENGTH_BUCKET_MIN = 10;
 export declare const PROMPT_LENGTH_BUCKET_MAX = 100;
-/** The percentile that sets `bucketMax`; everything above lands in the overflow. */
-export declare const PROMPT_LENGTH_OVERFLOW_PERCENTILE = 0.9;
+/** The percentile that sets `bucketMax`; everything above it lands in `tail`. */
+export declare const PROMPT_LENGTH_AXIS_PERCENTILE = 0.9;
+/** The server's cap on `tail` entries; longer distributions are coarsened. */
+export declare const PROMPT_TAIL_MAX_ENTRIES = 400;
 /** Matches the backend's cap — anything longer is truncated before upload. */
 export declare const CONVERSATION_SAMPLE_MAX_CHARS = 20000;
 export type PromptStatsProject = {
@@ -10,6 +12,27 @@ export type PromptStatsProject = {
     promptCount: number;
     lastActiveAt: string;
 };
+/** One session's running aggregate, as both the tick and a full scan build it. */
+export type PromptSessionAggregate = {
+    /** ISO timestamp of the first prompt seen in this session. */
+    startedAt: string;
+    /** ISO timestamp of the most recent one. */
+    lastActiveAt: string;
+    promptCount: number;
+};
+/** One day's running tally. Cumulative for this machine, never a delta. */
+export type PromptDayAggregate = {
+    prompts: number;
+    words: number;
+};
+/**
+ * The whole prompt-activity aggregate, keyed for cheap merging: sessions by
+ * session id, days by YYYY-MM-DD.
+ */
+export type PromptActivityAggregate = {
+    sessions: Record<string, PromptSessionAggregate>;
+    daily: Record<string, PromptDayAggregate>;
+};
 export type PromptStats = {
     totalPrompts: number;
     bucketMax: number;
@@ -17,7 +40,27 @@ export type PromptStats = {
         length: number;
         count: number;
     }[];
+    /**
+     * The exact distribution above `bucketMax`, and the only place those prompts
+     * are reported — the histogram stops at `bucketMax`. One entry per distinct
+     * word count, ascending, coarsened if there are more than
+     * `PROMPT_TAIL_MAX_ENTRIES` of them. Always present, empty when nothing
+     * exceeds `bucketMax`: the field's presence is what tells the server this
+     * histogram is exact, as opposed to a legacy snapshot whose last bar lumped
+     * everything at or above `bucketMax`.
+     */
+    tail: {
+        length: number;
+        count: number;
+    }[];
     projects: PromptStatsProject[];
+    /**
+     * Sessions and per-day counts for the whole local history. Not part of the
+     * `promptStats` block on the wire — the caller hands it to `stageFullScan`,
+     * which re-bases the tick's incremental state on it and works out which rows
+     * this upload still has to carry.
+     */
+    activity: PromptActivityAggregate;
     /** Only ever set under the `full` consent tier. */
     conversationSample?: string;
 };
@@ -34,9 +77,43 @@ export type PromptStats = {
 export declare function promptTextFrom(entry: unknown): string | null;
 /** Whitespace-separated word count. Zero-word prompts are dropped by callers. */
 export declare function countWords(text: string): number;
+/** The server's cap on a session id. Longer than this and the row is rejected. */
+export declare const PROMPT_SESSION_ID_MAX_CHARS = 128;
+/** One prompt, reduced to the three facts the activity aggregate needs. */
+export type PromptLine = {
+    sessionId: string;
+    /** Canonical ISO-8601 UTC, so string order is time order. */
+    timestamp: string;
+    words: number;
+};
 /**
- * The overflow threshold for this user's own distribution: their p90 prompt
- * length rounded up to a multiple of 10, clamped to [10, 100].
+ * A transcript line as prompt activity, or null when it isn't one.
+ *
+ * Stricter than `promptTextFrom` on purpose: a prompt with no session id or no
+ * usable timestamp can't be placed on a session or a day, and the server's
+ * schema would reject it, so it counts towards the histogram (which needs
+ * neither) and nothing else.
+ */
+export declare function parsePromptLine(line: string): PromptLine | null;
+/** An ISO-8601 UTC string, or null when the value isn't a usable instant. */
+export declare function normalizeTimestamp(value: unknown): string | null;
+export declare function emptyPromptActivity(): PromptActivityAggregate;
+/**
+ * Fold one prompt into an activity aggregate, returning the session and date it
+ * landed on so an incremental caller can mark exactly those dirty.
+ *
+ * The date is the UTC day of the timestamp — the same attribution
+ * `toDateStr` gives every token daily row, so the two halves of a sync agree
+ * about which day a piece of work belongs to.
+ */
+export declare function addPromptToActivity(activity: PromptActivityAggregate, line: PromptLine): {
+    sessionId: string;
+    date: string;
+};
+/**
+ * Where the histogram's axis ends for this user's own distribution: their p90
+ * prompt length rounded up to a multiple of 10, clamped to [10, 100]. Anything
+ * longer is reported by `buildTail` instead.
  *
  * Per-user rather than fixed because prompt length varies enormously between
  * people — a fixed axis would either crush a terse user's histogram into the
@@ -44,14 +121,40 @@ export declare function countWords(text: string): number;
  */
 export declare function bucketMaxFor(wordCounts: number[]): number;
 /**
- * Bucket the word counts. Buckets `1..bucketMax-1` are exact word counts; the
- * bucket at `bucketMax` is the overflow, holding every prompt that long or
- * longer. Empty buckets are omitted — the chart fills the gaps.
+ * Bucket the word counts. Every bucket `1..bucketMax` is an exact word count —
+ * there is no overflow bar. Empty buckets are omitted; the chart fills the gaps.
+ *
+ * Prompts longer than `bucketMax` are not in here at all: they are reported by
+ * `buildTail`, and only there. So the histogram and the tail partition the
+ * scan — sum(histogram counts) + sum(tail counts) === totalPrompts, always.
  */
 export declare function buildHistogram(wordCounts: number[], bucketMax: number): {
     length: number;
     count: number;
 }[];
+/**
+ * The exact distribution of everything *longer* than `bucketMax`, which the
+ * histogram does not cover at all. One entry per distinct word count,
+ * ascending; empty (never absent) when nothing exceeds `bucketMax` — the
+ * field's presence on the wire is the marker that the histogram's bars are
+ * exact.
+ *
+ * Lengths only — no prompt text is involved here, or anywhere near it.
+ *
+ * A machine with a long history can have thousands of distinct long lengths,
+ * far past what the server accepts, so an over-cap tail is coarsened: lengths
+ * are rounded to multiples of 2, then 4, 8, … until at most
+ * `PROMPT_TAIL_MAX_ENTRIES` entries remain, summing the counts that collapse
+ * together. Rounding is *up* so that a coarsened entry still sits above
+ * `bucketMax` — rounding down could claim a length inside the histogram's own
+ * exact range for a prompt the histogram never counted.
+ *
+ * Deterministic: the result depends only on the multiset of word counts.
+ */
+export declare function buildTail(wordCounts: number[], bucketMax: number): {
+    length: number;
+    count: number;
+}[];
 /**
  * The `origin` remote of the repo at `cwd`, or null when there isn't one (not
  * a repo, no origin, no git binary, or the directory is gone). The URL is sent
@@ -69,4 +172,10 @@ export declare function gitOriginUrl(cwd: string): Promise<string | null>;
 export declare function scanPromptStats(options?: {
     includeSample?: boolean;
 }): Promise<PromptStats | null>;
+/**
+ * The `promptStats` block as the server takes it. `activity` is deliberately
+ * dropped: it is local bookkeeping for the tick's incremental state, and it
+ * travels under its own top-level `promptActivity` field instead.
+ */
+export declare function promptStatsPayload(stats: PromptStats): Omit<PromptStats, 'activity'>;
 //# sourceMappingURL=prompt-stats.d.ts.map

package/dist/prompt-stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-stats.d.ts","sourceRoot":"","sources":["../src/prompt-stats.ts"],"names":[],"mappings":"AA6BA,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAC1C,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAC3C,oFAAoF;AACpF,eAAO,MAAM,iCAAiC,MAAM,CAAA;AACpD,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,QAAS,CAAA;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC9C,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAwB5D;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAazD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAUrC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYtE;AAQD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAoF7B"}
+{"version":3,"file":"prompt-stats.d.ts","sourceRoot":"","sources":["../src/prompt-stats.ts"],"names":[],"mappings":"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"}