@nexrall/code-core 1.4.76 → 1.4.78

package/dist/events/sessionStats.d.ts

@@ -0,0 +1,89 @@
+/** Days shown in the sparkline window. */
+export declare const STATS_DAYS = 14;
+/** Newest event logs read per call — a heavy user can accumulate hundreds. */
+export declare const MAX_EVENT_FILES = 100;
+/** The two event types `/stats` reads, narrowed to the fields it needs. */
+export interface UsageEventLite {
+    ts: number;
+    type: 'message.started' | 'message.completed';
+    /** message.started: the alias the CLI asked for. */
+    model?: string;
+    /** message.completed: total tokens of the turn, when reported. */
+    tokens?: number;
+    /** message.completed: USD, or null when the server reported none. */
+    cost?: number | null;
+}
+export interface DayUsage {
+    /** Local calendar day, YYYY-MM-DD. */
+    day: string;
+    requests: number;
+    tokens: number;
+}
+/** A counted name (`claude-sonnet-5-5` ×12) — structurally identical to the
+ * CLI's costPanel.Tally; kept local so core does not import from the CLI. */
+export interface Tally {
+    name: string;
+    count: number;
+}
+export interface UsageStats {
+    requests: number;
+    tokens: number;
+    costUsd: number;
+    /** completed rows that carried a numeric cost. */
+    costReported: number;
+    /** completed rows with no cost — the panel says "n did not report" rather than adding $0. */
+    costMissing: number;
+    models: Tally[];
+    /** Every day that saw at least one event, ascending. */
+    days: DayUsage[];
+    busiest: DayUsage | null;
+    firstTs: number | null;
+    lastTs: number | null;
+}
+export interface StatsMeta {
+    savedSessions: number;
+    sessionsWithLogs: number;
+    /** How many of those logs were actually read this call (≤ MAX_EVENT_FILES). */
+    readFiles: number;
+}
+/** What the panel puts on its closing `this run` row — this process's own numbers. */
+export interface ThisRun {
+    turns: number;
+    toolCalls: number;
+    ms: number;
+    tokens: number;
+    costUsd: number;
+    costReported: boolean;
+}
+/** Local calendar day of a timestamp. Local, not UTC: "today" must mean the user's today. */
+export declare function dayKey(ts: number): string;
+/** `Oct 3` — no year: this is recent-activity data and a year costs 5 columns on every row. */
+export declare function shortDate(ts: number): string;
+/**
+ * The day keys of the last `n` local days ending at `now`, oldest first.
+ * Calendar arithmetic via setDate (not `now - i*86_400_000`): subtracting
+ * fixed MS across a DST change skips or repeats a local day.
+ */
+export declare function lastDays(now: number, n: number): string[];
+/**
+ * Narrow one raw JSONL row to the fields the panel reads, or drop it.
+ * Tolerant by design: a trimmed tail can cut the last line mid-JSON, and the
+ * format is versioned (`v`) — unknown shapes must disappear quietly, never
+ * throw in the middle of a /stats.
+ */
+export declare function liteEvent(row: unknown): UsageEventLite | null;
+/** All the arithmetic of the panel; pure so every tally rule is unit-testable. */
+export declare function aggregateUsage(events: UsageEventLite[]): UsageStats;
+/** Eight-level block sparkline; zero maps to the floor glyph so gaps stay visible as a baseline. */
+export declare function sparkline(values: number[]): string;
+export interface LoadedUsage extends StatsMeta {
+    events: UsageEventLite[];
+}
+/**
+ * Read the newest event logs and narrow them to UsageEventLite rows.
+ * Everything here is best-effort: a missing directory (fresh install), an
+ * unreadable file or a torn JSON line must degrade the panel, never fail the
+ * command — the numbers are a courtesy, the session is the job.
+ */
+export declare function loadUsageStats(env?: NodeJS.ProcessEnv): LoadedUsage;
+//# sourceMappingURL=sessionStats.d.ts.map

package/dist/events/sessionStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStats.d.ts","sourceRoot":"","sources":["../../src/events/sessionStats.ts"],"names":[],"mappings":"AAyBA,0CAA0C;AAC1C,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,8EAA8E;AAC9E,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;IAC9C,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;6EAC6E;AAC7E,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,wDAAwD;IACxD,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sFAAsF;AACtF,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;CACvB;AAID,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIzC;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAgB7D;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU,CA0DnE;AAID,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAKlD;AAID,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,WAAW,CAmDhF"}

package/dist/events/sessionStats.js

@@ -0,0 +1,264 @@
+"use strict";
+// Lives in core (split from the CLI's ui/sessionStats.ts, 2026-10-04): the VS
+// Code panel aggregates the SAME event logs for /stats. The CLI module keeps
+// only formatStatsPanel (the ANSI-coloured rendering).
+// S17b — the `/stats` panel: usage ACROSS sessions, from the local §92 event
+// logs (each session writes `<sessions-root>/events/<id>.jsonl`).
+//
+// WHY: `/cost` answers "what is THIS session spending"; Claude Code's /stats
+// class of panel answers "how much have I been using this thing" — activity by
+// day, totals, favourite model. Nothing else in the CLI shows history, and the
+// event logs already carry every number (`message.started` → model,
+// `message.completed` → tokens/cost/duration), so the panel is pure arithmetic
+// over files we already wrote. No server, no new recording.
+//
+// Deliberate limits, stated because the numbers must not overpromise:
+//   - Logs are trimmed at 2MB/1000 events, so old huge sessions lose detail.
+//   - Only the newest MAX_EVENT_FILES logs are read; the panel says so when
+//     that cap actually bites.
+//   - Cost is only summed when the server reported it (same rule as /cost).
+// Pure (no console, no Ink) so the aggregation is unit-testable — see
+// test/sessionStats.test.mts.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_EVENT_FILES = exports.STATS_DAYS = void 0;
+exports.dayKey = dayKey;
+exports.shortDate = shortDate;
+exports.lastDays = lastDays;
+exports.liteEvent = liteEvent;
+exports.aggregateUsage = aggregateUsage;
+exports.sparkline = sparkline;
+exports.loadUsageStats = loadUsageStats;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/** Days shown in the sparkline window. */
+exports.STATS_DAYS = 14;
+/** Newest event logs read per call — a heavy user can accumulate hundreds. */
+exports.MAX_EVENT_FILES = 100;
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/** Local calendar day of a timestamp. Local, not UTC: "today" must mean the user's today. */
+function dayKey(ts) {
+    const d = new Date(ts);
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
+}
+/** `Oct 3` — no year: this is recent-activity data and a year costs 5 columns on every row. */
+function shortDate(ts) {
+    const d = new Date(ts);
+    return `${MONTHS[d.getMonth()]} ${d.getDate()}`;
+}
+/**
+ * The day keys of the last `n` local days ending at `now`, oldest first.
+ * Calendar arithmetic via setDate (not `now - i*86_400_000`): subtracting
+ * fixed MS across a DST change skips or repeats a local day.
+ */
+function lastDays(now, n) {
+    const out = [];
+    for (let i = n - 1; i >= 0; i--) {
+        const d = new Date(now);
+        d.setDate(d.getDate() - i);
+        out.push(dayKey(d.getTime()));
+    }
+    return out;
+}
+/**
+ * Narrow one raw JSONL row to the fields the panel reads, or drop it.
+ * Tolerant by design: a trimmed tail can cut the last line mid-JSON, and the
+ * format is versioned (`v`) — unknown shapes must disappear quietly, never
+ * throw in the middle of a /stats.
+ */
+function liteEvent(row) {
+    if (typeof row !== 'object' || row === null)
+        return null;
+    const r = row;
+    if (typeof r.ts !== 'number' || !Number.isFinite(r.ts))
+        return null;
+    if (r.type === 'message.started') {
+        return { ts: r.ts, type: 'message.started', model: typeof r.model === 'string' && r.model ? r.model : undefined };
+    }
+    if (r.type === 'message.completed') {
+        return {
+            ts: r.ts,
+            type: 'message.completed',
+            tokens: typeof r.tokens === 'number' && Number.isFinite(r.tokens) ? r.tokens : undefined,
+            cost: typeof r.cost === 'number' && Number.isFinite(r.cost) ? r.cost : null,
+        };
+    }
+    return null;
+}
+/** All the arithmetic of the panel; pure so every tally rule is unit-testable. */
+function aggregateUsage(events) {
+    const models = new Map();
+    const byDay = new Map();
+    let requests = 0;
+    let tokens = 0;
+    let costUsd = 0;
+    let costReported = 0;
+    let costMissing = 0;
+    let firstTs = null;
+    let lastTs = null;
+    for (const e of events) {
+        if (firstTs === null || e.ts < firstTs)
+            firstTs = e.ts;
+        if (lastTs === null || e.ts > lastTs)
+            lastTs = e.ts;
+        const day = dayKey(e.ts);
+        let d = byDay.get(day);
+        if (!d)
+            byDay.set(day, (d = { day, requests: 0, tokens: 0 }));
+        if (e.type === 'message.started') {
+            requests++;
+            d.requests++;
+            if (e.model)
+                models.set(e.model, (models.get(e.model) ?? 0) + 1);
+        }
+        else {
+            const t = e.tokens ?? 0;
+            tokens += t;
+            d.tokens += t;
+            if (e.cost === null || e.cost === undefined)
+                costMissing++;
+            else {
+                costUsd += e.cost;
+                costReported++;
+            }
+        }
+    }
+    const days = [...byDay.values()].sort((a, b) => a.day.localeCompare(b.day));
+    let busiest = null;
+    for (const d of days) {
+        if (!busiest ||
+            d.tokens > busiest.tokens ||
+            (d.tokens === busiest.tokens && d.requests > busiest.requests) ||
+            // Full tie: the LATER day wins — "busiest" reads as "the most recent time it was this busy".
+            (d.tokens === busiest.tokens && d.requests === busiest.requests && d.day > busiest.day)) {
+            busiest = d;
+        }
+    }
+    return {
+        requests,
+        tokens,
+        costUsd,
+        costReported,
+        costMissing,
+        models: [...models.entries()]
+            .map(([name, count]) => ({ name, count }))
+            .sort((a, b) => b.count - a.count || a.name.localeCompare(b.name)),
+        days,
+        busiest,
+        firstTs,
+        lastTs,
+    };
+}
+const SPARK_LEVELS = ['\u2581', '\u2582', '\u2583', '\u2584', '\u2585', '\u2586', '\u2587', '\u2588'];
+/** Eight-level block sparkline; zero maps to the floor glyph so gaps stay visible as a baseline. */
+function sparkline(values) {
+    if (!values.length)
+        return '';
+    const max = Math.max(...values);
+    if (max <= 0)
+        return SPARK_LEVELS[0].repeat(values.length);
+    return values.map((v) => SPARK_LEVELS[Math.min(7, Math.max(0, Math.floor((v / max) * 7)))]).join('');
+}
+function sessionsRoot(env) {
+    return env.NEXRALL_CLI_SESSIONS_DIR || path.join(os.homedir(), '.nexrall', 'cli-sessions');
+}
+/**
+ * Read the newest event logs and narrow them to UsageEventLite rows.
+ * Everything here is best-effort: a missing directory (fresh install), an
+ * unreadable file or a torn JSON line must degrade the panel, never fail the
+ * command — the numbers are a courtesy, the session is the job.
+ */
+function loadUsageStats(env = process.env) {
+    const root = sessionsRoot(env);
+    const dir = path.join(root, 'events');
+    let names;
+    try {
+        names = fs.readdirSync(dir).filter((f) => f.endsWith('.jsonl'));
+    }
+    catch {
+        names = [];
+    }
+    const sessionsWithLogs = names.length;
+    // Newest first, by mtime — ids are hex so name order ≈ creation order, but
+    // a resumed session keeps its id and grows old, so mtime is the honest key.
+    const dated = names
+        .map((f) => {
+        let m = 0;
+        try {
+            m = fs.statSync(path.join(dir, f)).mtimeMs;
+        }
+        catch {
+            /* keep 0 — sorted last */
+        }
+        return { f, m };
+    })
+        .sort((a, b) => b.m - a.m)
+        .slice(0, exports.MAX_EVENT_FILES);
+    const events = [];
+    for (const { f } of dated) {
+        let raw;
+        try {
+            raw = fs.readFileSync(path.join(dir, f), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        for (const line of raw.split('\n')) {
+            if (!line.trim())
+                continue;
+            let obj;
+            try {
+                obj = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            const lite = liteEvent(obj);
+            if (lite)
+                events.push(lite);
+        }
+    }
+    let savedSessions;
+    try {
+        savedSessions = fs.readdirSync(root).filter((f) => f.endsWith('.json')).length;
+    }
+    catch {
+        savedSessions = 0;
+    }
+    return { events, savedSessions, sessionsWithLogs, readFiles: dated.length };
+}
+//# sourceMappingURL=sessionStats.js.map

package/dist/import/claudeImport.d.ts

@@ -0,0 +1,44 @@
+export type ImportKind = 'command' | 'agent' | 'skill' | 'brief' | 'permissions' | 'hooks';
+export interface PlanItem {
+    kind: ImportKind;
+    /** Source path (file or directory). */
+    from: string;
+    /** Destination path. For settings merges, the settings file. */
+    to: string;
+    status: 'copy' | 'merge' | 'skip-exists' | 'skip-empty';
+    /** One-line human detail (e.g. "3 allow rules"). */
+    note?: string;
+}
+export interface ImportPlan {
+    items: PlanItem[];
+    /** settings.json keys found in the source that nex deliberately does not import. */
+    ignoredSettings: string[];
+    /** Nothing to import was found at all. */
+    empty: boolean;
+}
+/** Renamed from `Scope` (2026-10-04) to avoid colliding with the search
+ *  engine's Scope in core's index; same meaning, import-specific name. */
+export type ImportScope = 'project' | 'user';
+export interface Roots {
+    /** The Claude side: a directory containing `.claude/` and maybe CLAUDE.md. */
+    sourceBase: string;
+    /** The nex side: a directory that will contain `.nexrall/` and nexrall.md. */
+    destBase: string;
+    /** user scope reads/writes ~/.claude → ~/.nexrall and has no brief file. */
+    scope: ImportScope;
+}
+export declare function planImport(r: Roots): ImportPlan;
+export interface ApplyResult {
+    done: PlanItem[];
+    failed: Array<{
+        item: PlanItem;
+        error: string;
+    }>;
+}
+/**
+ * Carry out a plan. Idempotent: a second run finds everything already present and does nothing.
+ * Settings are merged additively — existing rules and hooks are kept, new ones appended.
+ */
+export declare function applyImport(plan: ImportPlan): ApplyResult;
+export declare function formatPlan(plan: ImportPlan, apply: boolean, base: string): string[];
+//# sourceMappingURL=claudeImport.d.ts.map

package/dist/import/claudeImport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeImport.d.ts","sourceRoot":"","sources":["../../src/import/claudeImport.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,OAAO,CAAC;AAC3F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,YAAY,CAAC;IACxD,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,oFAAoF;IACpF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;0EAC0E;AAC1E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAoD7C,MAAM,WAAW,KAAK;IACpB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,CA2F/C;AAoBD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAmEzD;AAWD,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA+BnF"}