@project-ava-supernova/core 0.2.71

package/dist/billing/meter.js

@@ -0,0 +1,67 @@
+// Credit meter — the runtime side of the Ava Credits system.
+//
+// Every metered action (LLM call, Creative Studio generation, orchestration
+// hop, Teach session) calls `chargeCredits()` on completion. The helper
+// emits a `credits_charged` dataset event that rolls up into usage reports
+// and, once Stage 3 flips the switch, into per-user billing.
+//
+// Stage 2 (this file): dual-write only. Server-side billing continues to
+// read raw tokens; the `credits` field is recorded for parity audit.
+// Stage 3 (later): flip the feature flag, server reads credits first,
+// raw tokens become backup-only.
+//
+// Design choices:
+//  - Emission is fire-and-forget via avaEvents (microtask-safe). The
+//    user-visible response never blocks on metering.
+//  - No trajectory scope required — if no trajectory is open, avaEvents
+//    drops the emit silently. That's safer than throwing from a billing
+//    path.
+//  - Cache-hit discount is applied here at emit time via creditsFor().
+//    Callers pass `{ cacheHit: true }` when the provider response
+//    indicates a prompt-cache hit; the 0.3× multiplier lives in credits.ts.
+import { avaEvents } from '../dataset/emitter.js';
+import { creditsFor } from './credits.js';
+/**
+ * Charge credits for a completed metered action.
+ *
+ * Returns the credits deducted so callers can log or accumulate. Emits
+ * a `credits_charged` dataset event for the usage pipeline. Never throws
+ * and never blocks — billing failures cannot take the chat down.
+ */
+export function chargeCredits(action, opts) {
+    const credits = creditsFor(action, { cacheHit: opts?.cacheHit, model: opts?.model });
+    avaEvents.emit('credits_charged', {
+        action,
+        credits,
+        cache_hit: opts?.cacheHit ?? false,
+        raw_input_tokens: opts?.rawTokens?.input,
+        raw_output_tokens: opts?.rawTokens?.output,
+        raw_cached_tokens: opts?.rawTokens?.cached,
+        model: opts?.model,
+    });
+    return credits;
+}
+/**
+ * Extract raw usage from a provider's CompletionResponse usage field.
+ * Defensive — providers return usage in varied shapes; this normalises
+ * to the dual-write envelope. Returns undefined if no usage is present
+ * (some error paths, some provider non-compliance).
+ */
+export function extractUsage(usage) {
+    if (!usage)
+        return undefined;
+    const input = usage.input_tokens ?? usage.prompt_tokens;
+    const output = usage.output_tokens ?? usage.completion_tokens;
+    // Nested first — it is the portable location.
+    const cached = usage.prompt_tokens_details?.cached_tokens
+        ?? usage.cached_tokens
+        ?? usage.prompt_cache_hit_tokens;
+    if (input == null && output == null)
+        return undefined;
+    return {
+        input: input ?? 0,
+        output: output ?? 0,
+        ...(cached != null && { cached }),
+    };
+}
+//# sourceMappingURL=meter.js.map

package/dist/billing/meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.js","sourceRoot":"","sources":["../../src/billing/meter.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,2EAA2E;AAC3E,6DAA6D;AAC7D,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,kBAAkB;AAClB,qEAAqE;AACrE,qDAAqD;AACrD,wEAAwE;AACxE,wEAAwE;AACxE,WAAW;AACX,uEAAuE;AACvE,kEAAkE;AAClE,4EAA4E;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAiB1C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB,EAAE,IAAiB;IACnE,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrF,SAAS,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAChC,MAAM;QACN,OAAO;QACP,SAAS,EAAE,IAAI,EAAE,QAAQ,IAAI,KAAK;QAClC,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK;QACxC,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM;QAC1C,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM;QAC1C,KAAK,EAAE,IAAI,EAAE,KAAK;KACnB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,KAWoB;IAEpB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,aAAa,CAAC;IACxD,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,iBAAiB,CAAC;IAC9D,8CAA8C;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,qBAAqB,EAAE,aAAa;WACpD,KAAK,CAAC,aAAa;WACnB,KAAK,CAAC,uBAAuB,CAAC;IACnC,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACtD,OAAO;QACL,KAAK,EAAE,KAAK,IAAI,CAAC;QACjB,MAAM,EAAE,MAAM,IAAI,CAAC;QACnB,GAAG,CAAC,MAAM,IAAI,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/billing/plans.d.ts

@@ -0,0 +1,34 @@
+export * from './credits.js';
+export type PlanTier = 'free' | 'pro' | 'ultra' | 'enterprise' | 'admin';
+export interface PlanDefinition {
+    /** Display name (Free, Pro, Ultra, Enterprise). */
+    name: string;
+    /** Monthly USD price. Zero for free/admin. */
+    price: number;
+    /** Monthly Ava Credits allowance. */
+    credits: number;
+    /** Included cloud storage in GB (before add-ons). */
+    storageGb: number;
+    /** API requests per minute. */
+    rateLimit: number;
+    /** Decision-critical feature bullets shown on upgrade cards. */
+    features: string[];
+}
+export declare const PLANS: Record<PlanTier, PlanDefinition>;
+import { type CreditTopupDefinition } from './credits.js';
+/** @deprecated — use CreditTopupDefinition. */
+export type TokenTopupDefinition = CreditTopupDefinition;
+/** @deprecated — use CREDIT_TOPUPS. Points at the same array. */
+export declare const TOKEN_TOPUPS: CreditTopupDefinition[];
+export declare const AVA_SITE_BASE = "https://avasupernova.com";
+/** Public pricing page — plan cards + top-ups all on one page. */
+export declare function pricingUrl(): string;
+/** Dashboard billing — current plan, Stripe portal, active top-ups. Signed-in view. */
+export declare function dashboardBillingUrl(): string;
+/** Pricing page with intent hint so the page can highlight the right card. */
+export declare function upgradeUrl(target: Exclude<PlanTier, 'free' | 'admin'>): string;
+/** Pricing page scrolled to the top-up grid. */
+export declare function creditTopupUrl(topup: CreditTopupDefinition['id']): string;
+/** @deprecated — use creditTopupUrl. */
+export declare const tokenTopupUrl: typeof creditTopupUrl;
+//# sourceMappingURL=plans.d.ts.map

package/dist/billing/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/billing/plans.ts"],"names":[],"mappings":"AAYA,cAAc,cAAc,CAAC;AAE7B,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,cAAc,CAgElD,CAAC;AAOF,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzE,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEzD,iEAAiE;AACjE,eAAO,MAAM,YAAY,EAAE,qBAAqB,EAAkB,CAAC;AAOnE,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD,kEAAkE;AAClE,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CAE9E;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC,IAAI,CAAC,GAAG,MAAM,CAEzE;AAED,wCAAwC;AACxC,eAAO,MAAM,aAAa,uBAAiB,CAAC"}

package/dist/billing/plans.js

@@ -0,0 +1,108 @@
+// Canonical plan, top-up, and storage add-on definitions used across every
+// Ava surface (web, extension, IDE). Post-credits rename (migration 203):
+// allowances are denominated in Ava Credits, not raw Qwen tokens. Credit
+// cost per action lives in ./credits.ts and is re-exported from this module
+// so every consumer imports from a single path.
+//
+// Everything here is pure data + pure URL builders — no runtime deps, safe
+// to import from any surface that takes @ava/core.
+// Re-export the action-cost table + credit helpers so importers of
+// @ava/core/billing can get everything (plans + credit pricing) without
+// chasing sub-paths.
+export * from './credits.js';
+export const PLANS = {
+    free: {
+        name: 'Free',
+        price: 0,
+        credits: 300,
+        storageGb: 2,
+        rateLimit: 20,
+        features: [
+            '300 credits / month',
+            '4 fleets + single models on credits',
+            'Any model via BYOK — costs no credits',
+            'Every surface — extension, IDE, companion',
+        ],
+    },
+    pro: {
+        name: 'Pro',
+        price: 19,
+        credits: 5_000,
+        storageGb: 25,
+        rateLimit: 60,
+        features: [
+            '5,000 credits / month',
+            '4 fleets + single models on credits',
+            'Top-up credits anytime',
+            '60 requests / minute',
+            'Priority support',
+        ],
+    },
+    ultra: {
+        name: 'Ultra',
+        price: 39,
+        credits: 10_000,
+        storageGb: 100,
+        rateLimit: 120,
+        features: [
+            '10,000 credits / month',
+            '4 fleets + single models on credits',
+            '120 requests / minute',
+            'Highest-priority routing',
+            'Early access to new models',
+        ],
+    },
+    enterprise: {
+        name: 'Enterprise',
+        price: 79,
+        credits: 20_000,
+        storageGb: 500,
+        rateLimit: 200,
+        features: [
+            '20,000 credits / month',
+            '4 fleets + single models on credits',
+            '200 requests / minute',
+            'SSO + dedicated support',
+            'Custom integrations on request',
+        ],
+    },
+    admin: {
+        name: 'Admin',
+        price: 0,
+        credits: 999_999_999,
+        storageGb: 10_000,
+        rateLimit: 999,
+        features: [],
+    },
+};
+// ── Top-up shapes ────────────────────────────────────────────────────────
+// The authoritative top-up catalog lives in credits.ts (CREDIT_TOPUPS +
+// CreditTopupDefinition). Deprecated token-era aliases below keep any
+// import site we haven't migrated compiling.
+import { CREDIT_TOPUPS } from './credits.js';
+/** @deprecated — use CREDIT_TOPUPS. Points at the same array. */
+export const TOKEN_TOPUPS = CREDIT_TOPUPS;
+// ── Website URL builders ──────────────────────────────────────────────────
+// Surfaces that can't host checkout themselves (the VS Code webview sandbox,
+// Tauri's blocked origins) redirect the user to the website. One helper
+// per destination keeps the URL in one place.
+export const AVA_SITE_BASE = 'https://avasupernova.com';
+/** Public pricing page — plan cards + top-ups all on one page. */
+export function pricingUrl() {
+    return `${AVA_SITE_BASE}/pricing`;
+}
+/** Dashboard billing — current plan, Stripe portal, active top-ups. Signed-in view. */
+export function dashboardBillingUrl() {
+    return `${AVA_SITE_BASE}/dashboard/billing`;
+}
+/** Pricing page with intent hint so the page can highlight the right card. */
+export function upgradeUrl(target) {
+    return `${AVA_SITE_BASE}/pricing?upgrade=${target}`;
+}
+/** Pricing page scrolled to the top-up grid. */
+export function creditTopupUrl(topup) {
+    return `${AVA_SITE_BASE}/pricing?topup=${topup}#credits`;
+}
+/** @deprecated — use creditTopupUrl. */
+export const tokenTopupUrl = creditTopupUrl;
+//# sourceMappingURL=plans.js.map

package/dist/billing/plans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.js","sourceRoot":"","sources":["../../src/billing/plans.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,gDAAgD;AAChD,EAAE;AACF,2EAA2E;AAC3E,mDAAmD;AAEnD,mEAAmE;AACnE,wEAAwE;AACxE,qBAAqB;AACrB,cAAc,cAAc,CAAC;AAmB7B,MAAM,CAAC,MAAM,KAAK,GAAqC;IACrD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE;YACR,qBAAqB;YACrB,qCAAqC;YACrC,uCAAuC;YACvC,2CAA2C;SAC5C;KACF;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE;YACR,uBAAuB;YACvB,qCAAqC;YACrC,wBAAwB;YACxB,sBAAsB;YACtB,kBAAkB;SACnB;KACF;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE;YACR,wBAAwB;YACxB,qCAAqC;YACrC,uBAAuB;YACvB,0BAA0B;YAC1B,4BAA4B;SAC7B;KACF;IACD,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE;YACR,wBAAwB;YACxB,qCAAqC;YACrC,uBAAuB;YACvB,yBAAyB;YACzB,gCAAgC;SACjC;KACF;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF,4EAA4E;AAC5E,wEAAwE;AACxE,sEAAsE;AACtE,6CAA6C;AAE7C,OAAO,EAAE,aAAa,EAA8B,MAAM,cAAc,CAAC;AAKzE,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAA4B,aAAa,CAAC;AAEnE,6EAA6E;AAC7E,6EAA6E;AAC7E,wEAAwE;AACxE,8CAA8C;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAExD,kEAAkE;AAClE,MAAM,UAAU,UAAU;IACxB,OAAO,GAAG,aAAa,UAAU,CAAC;AACpC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB;IACjC,OAAO,GAAG,aAAa,oBAAoB,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,MAA2C;IACpE,OAAO,GAAG,aAAa,oBAAoB,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,KAAkC;IAC/D,OAAO,GAAG,aAAa,kBAAkB,KAAK,UAAU,CAAC;AAC3D,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC"}

package/dist/briefing/briefing-engine.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Daily Briefing Engine — Ava's proactive morning greeting.
+ *
+ * Gathers context from tasks, journal, memory, and time to produce
+ * a natural, personalised greeting when the user opens the extension or CLI.
+ *
+ * This is the JARVIS transition — Ava stops being reactive and becomes proactive.
+ */
+import type { TaskManager } from '../tasks/task-manager.js';
+import type { JournalManager } from '../journal/journal-manager.js';
+import type { MemoryManager } from '../memory/memory-manager.js';
+import type { BriefingData, Briefing } from './types.js';
+export declare class BriefingEngine {
+    private readonly globalDir;
+    private state;
+    constructor(opts: {
+        globalDir: string;
+    });
+    /**
+     * Check whether a briefing should be shown right now.
+     * Returns true if no briefing has been shown today.
+     */
+    shouldShowBriefing(): Promise<boolean>;
+    /**
+     * Generate a full daily briefing from all available context.
+     * Call this only after shouldShowBriefing() returns true.
+     */
+    generateBriefing(taskManager: TaskManager, journalManager: JournalManager, memoryManager: MemoryManager): Promise<Briefing>;
+    /**
+     * Generate briefing data without marking as shown.
+     * Useful for previewing or refreshing the dashboard widget.
+     */
+    generateBriefingData(taskManager: TaskManager, journalManager: JournalManager, memoryManager: MemoryManager): Promise<BriefingData>;
+    /** Reset briefing state (for testing or manual refresh). */
+    reset(): Promise<void>;
+    private gatherData;
+    private getRecentMemories;
+    private formatBriefing;
+    private formatGreeting;
+    private formatTasks;
+    private formatJournal;
+    private formatMemories;
+    private formatClosing;
+    private getTimeOfDay;
+    private todayDate;
+    private offsetDate;
+    private loadState;
+    private markShown;
+    private saveState;
+}
+//# sourceMappingURL=briefing-engine.d.ts.map

package/dist/briefing/briefing-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefing-engine.d.ts","sourceRoot":"","sources":["../../src/briefing/briefing-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAA4B,MAAM,YAAY,CAAC;AAMnF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,KAAK,CAA8B;gBAE/B,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE;IAMvC;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAM5C;;;OAGG;IACG,gBAAgB,CACpB,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,QAAQ,CAAC;IAcpB;;;OAGG;IACG,oBAAoB,CACxB,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,YAAY,CAAC;IAIxB,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAOd,UAAU;YAqDV,iBAAiB;IAsB/B,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,WAAW;IAgDnB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;YAQJ,SAAS;YA2BT,SAAS;YAST,SAAS;CAYxB"}

package/dist/briefing/briefing-engine.js

@@ -0,0 +1,289 @@
+/**
+ * Daily Briefing Engine — Ava's proactive morning greeting.
+ *
+ * Gathers context from tasks, journal, memory, and time to produce
+ * a natural, personalised greeting when the user opens the extension or CLI.
+ *
+ * This is the JARVIS transition — Ava stops being reactive and becomes proactive.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { localYmd, todayLocal } from '../core/dates.js';
+const BRIEFING_STATE_FILE = 'briefing-state.json';
+const DAYS = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+export class BriefingEngine {
+    globalDir;
+    state = null;
+    constructor(opts) {
+        this.globalDir = opts.globalDir;
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    /**
+     * Check whether a briefing should be shown right now.
+     * Returns true if no briefing has been shown today.
+     */
+    async shouldShowBriefing() {
+        const state = await this.loadState();
+        const today = this.todayDate();
+        return state.lastBriefingDate !== today;
+    }
+    /**
+     * Generate a full daily briefing from all available context.
+     * Call this only after shouldShowBriefing() returns true.
+     */
+    async generateBriefing(taskManager, journalManager, memoryManager) {
+        const data = await this.gatherData(taskManager, journalManager, memoryManager);
+        const text = this.formatBriefing(data);
+        // Mark briefing as shown
+        await this.markShown();
+        return {
+            text,
+            data,
+            generatedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Generate briefing data without marking as shown.
+     * Useful for previewing or refreshing the dashboard widget.
+     */
+    async generateBriefingData(taskManager, journalManager, memoryManager) {
+        return this.gatherData(taskManager, journalManager, memoryManager);
+    }
+    /** Reset briefing state (for testing or manual refresh). */
+    async reset() {
+        this.state = { lastBriefingDate: null, lastBriefingAt: null };
+        await this.saveState(this.state);
+    }
+    // ── Data Gathering ──────────────────────────────────────────────────────────
+    async gatherData(taskManager, journalManager, memoryManager) {
+        const now = new Date();
+        const today = this.todayDate();
+        const yesterday = this.offsetDate(today, -1);
+        // Gather all data in parallel
+        const [todayTasks, allTasks, yesterdayJournal, recentMemories,] = await Promise.all([
+            taskManager.getTodayTasks(),
+            taskManager.listTasks(),
+            journalManager.getDay(yesterday),
+            this.getRecentMemories(memoryManager),
+        ]);
+        // Find overdue tasks (due before today, not done/archived)
+        const overdueTasks = allTasks.filter(t => t.dueDate &&
+            t.dueDate < today &&
+            t.status !== 'done' &&
+            t.status !== 'archived');
+        // Count tasks completed yesterday
+        const completedYesterday = allTasks.filter(t => t.completedAt && t.completedAt.startsWith(yesterday)).length;
+        // Total active (not done/archived)
+        const totalActiveTasks = allTasks.filter(t => t.status !== 'done' && t.status !== 'archived').length;
+        return {
+            date: today,
+            timeOfDay: this.getTimeOfDay(now),
+            dayOfWeek: DAYS[now.getDay()],
+            todayTasks,
+            overdueTasks,
+            yesterdayJournal,
+            recentMemories,
+            totalActiveTasks,
+            completedYesterday,
+        };
+    }
+    async getRecentMemories(memoryManager) {
+        try {
+            const globalStore = await memoryManager.loadGlobalStore();
+            const projectStore = await memoryManager.loadProjectStore();
+            const allEntries = [
+                ...globalStore.entries,
+                ...(projectStore?.entries ?? []),
+            ];
+            // Sort by most recently updated, take top 5 non-archived
+            return allEntries
+                .filter(e => !e.archived)
+                .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime())
+                .slice(0, 5);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ── Formatting ──────────────────────────────────────────────────────────────
+    formatBriefing(data) {
+        const parts = [];
+        // Greeting
+        parts.push(this.formatGreeting(data));
+        // Tasks overview
+        const taskSection = this.formatTasks(data);
+        if (taskSection)
+            parts.push(taskSection);
+        // Yesterday's journal
+        const journalSection = this.formatJournal(data);
+        if (journalSection)
+            parts.push(journalSection);
+        // Recent memory context
+        const memorySection = this.formatMemories(data);
+        if (memorySection)
+            parts.push(memorySection);
+        // Closing
+        parts.push(this.formatClosing(data));
+        return parts.join('\n\n');
+    }
+    formatGreeting(data) {
+        const greetings = {
+            morning: ['Good morning.', 'Morning.'],
+            afternoon: ['Good afternoon.', 'Afternoon.'],
+            evening: ['Good evening.', 'Evening.'],
+            night: ['Burning the midnight oil.', 'Late one tonight.'],
+        };
+        const options = greetings[data.timeOfDay];
+        const greeting = options[Math.floor(Math.random() * options.length)];
+        return `${greeting} It's ${data.dayOfWeek}.`;
+    }
+    formatTasks(data) {
+        const lines = [];
+        // Overdue first — these need attention
+        if (data.overdueTasks.length > 0) {
+            const count = data.overdueTasks.length;
+            lines.push(`**${count} overdue ${count === 1 ? 'task' : 'tasks'}** need attention:`);
+            for (const task of data.overdueTasks.slice(0, 3)) {
+                const priority = task.priority === 'urgent' || task.priority === 'high' ? ` [${task.priority}]` : '';
+                lines.push(`- ${task.title}${priority} (due ${task.dueDate})`);
+            }
+            if (data.overdueTasks.length > 3) {
+                lines.push(`- ...and ${data.overdueTasks.length - 3} more`);
+            }
+        }
+        // Today's tasks
+        if (data.todayTasks.length > 0) {
+            if (lines.length > 0)
+                lines.push('');
+            const count = data.todayTasks.length;
+            lines.push(`**${count} ${count === 1 ? 'task' : 'tasks'} for today:**`);
+            for (const task of data.todayTasks.slice(0, 5)) {
+                const status = task.status === 'in-progress' ? ' (in progress)' : '';
+                lines.push(`- ${task.title}${status}`);
+            }
+            if (data.todayTasks.length > 5) {
+                lines.push(`- ...and ${data.todayTasks.length - 5} more`);
+            }
+        }
+        // Completed yesterday (positive reinforcement)
+        if (data.completedYesterday > 0) {
+            if (lines.length > 0)
+                lines.push('');
+            lines.push(`You completed ${data.completedYesterday} ${data.completedYesterday === 1 ? 'task' : 'tasks'} yesterday.`);
+        }
+        // Nothing at all
+        if (lines.length === 0 && data.totalActiveTasks === 0) {
+            return null;
+        }
+        if (lines.length === 0) {
+            lines.push(`${data.totalActiveTasks} active ${data.totalActiveTasks === 1 ? 'task' : 'tasks'} across your boards. Nothing due today.`);
+        }
+        return lines.join('\n');
+    }
+    formatJournal(data) {
+        if (!data.yesterdayJournal)
+            return null;
+        const entries = data.yesterdayJournal.entries;
+        const userEntry = entries.find((e) => e.author === 'user');
+        const entry = userEntry ?? entries[0];
+        if (!entry)
+            return null;
+        // Extract first meaningful line as a summary
+        const content = entry.content.trim();
+        const firstLine = content.split('\n')[0].slice(0, 120);
+        const source = userEntry ? 'your journal' : "yesterday's session";
+        return `From ${source}: "${firstLine}"${content.length > 120 ? '...' : ''}`;
+    }
+    formatMemories(data) {
+        if (data.recentMemories.length === 0)
+            return null;
+        // Only surface the most recent memory as context for "where you left off"
+        const latest = data.recentMemories[0];
+        const content = latest.content.split('\n')[0].slice(0, 100);
+        return `Last thing on your mind: ${content}${latest.content.length > 100 ? '...' : ''}`;
+    }
+    formatClosing(data) {
+        // Context-aware closing
+        if (data.overdueTasks.length > 0) {
+            return 'Want to tackle the overdue items first, or pick up where you left off?';
+        }
+        if (data.todayTasks.length > 0) {
+            const first = data.todayTasks[0];
+            if (first.status === 'in-progress') {
+                return `You were working on "${first.title}". Want to continue?`;
+            }
+            return 'Ready when you are.';
+        }
+        return 'What are we working on today?';
+    }
+    // ── Time Helpers ────────────────────────────────────────────────────────────
+    getTimeOfDay(date) {
+        const hour = date.getHours();
+        if (hour < 6)
+            return 'night';
+        if (hour < 12)
+            return 'morning';
+        if (hour < 17)
+            return 'afternoon';
+        if (hour < 21)
+            return 'evening';
+        return 'night';
+    }
+    todayDate() {
+        return todayLocal();
+    }
+    offsetDate(dateStr, days) {
+        const d = new Date(dateStr + 'T00:00:00');
+        d.setDate(d.getDate() + days);
+        return localYmd(d);
+    }
+    // ── State Persistence ───────────────────────────────────────────────────────
+    async loadState() {
+        if (this.state)
+            return this.state;
+        const filePath = join(this.globalDir, BRIEFING_STATE_FILE);
+        if (!existsSync(filePath)) {
+            this.state = { lastBriefingDate: null, lastBriefingAt: null };
+            return this.state;
+        }
+        try {
+            const raw = await readFile(filePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            // Validate shape — don't trust corrupted state
+            if (typeof parsed === 'object' && parsed !== null &&
+                (parsed.lastBriefingDate === null || typeof parsed.lastBriefingDate === 'string')) {
+                this.state = parsed;
+                return this.state;
+            }
+            // Invalid shape — reset
+            this.state = { lastBriefingDate: null, lastBriefingAt: null };
+            return this.state;
+        }
+        catch {
+            this.state = { lastBriefingDate: null, lastBriefingAt: null };
+            return this.state;
+        }
+    }
+    async markShown() {
+        const now = new Date();
+        this.state = {
+            lastBriefingDate: localYmd(now),
+            lastBriefingAt: now.toISOString(),
+        };
+        await this.saveState(this.state);
+    }
+    async saveState(state) {
+        await mkdir(this.globalDir, { recursive: true });
+        const filePath = join(this.globalDir, BRIEFING_STATE_FILE);
+        // Atomic write with lock — prevents race between show and persist
+        const { withLock } = await import('../core/file-lock.js');
+        await withLock(filePath, async () => {
+            const tmpPath = filePath + '.tmp';
+            await writeFile(tmpPath, JSON.stringify(state, null, 2), 'utf-8');
+            const { rename } = await import('node:fs/promises');
+            await rename(tmpPath, filePath);
+        });
+    }
+}
+//# sourceMappingURL=briefing-engine.js.map

package/dist/briefing/briefing-engine.js.map

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

package/dist/briefing/index.d.ts

@@ -0,0 +1,3 @@
+export { BriefingEngine } from './briefing-engine.js';
+export type { Briefing, BriefingData, BriefingState, TimeOfDay } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/briefing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/briefing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/briefing/index.js

@@ -0,0 +1,2 @@
+export { BriefingEngine } from './briefing-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/briefing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/briefing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/briefing/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Daily Briefing — Types for Ava's proactive morning greeting.
+ *
+ * The briefing gathers tasks, journal, memory, and time context
+ * to produce a natural, context-aware greeting when the user starts their day.
+ */
+import type { TaskEntry } from '../tasks/types.js';
+import type { JournalDay } from '../journal/types.js';
+import type { MemoryEntry } from '../memory/types.js';
+/** Time-of-day segment for greeting tone. */
+export type TimeOfDay = 'morning' | 'afternoon' | 'evening' | 'night';
+/** Raw data gathered before formatting. */
+export interface BriefingData {
+    /** Current date (YYYY-MM-DD). */
+    date: string;
+    /** Time of day for greeting tone. */
+    timeOfDay: TimeOfDay;
+    /** Day of week (e.g. "Monday"). */
+    dayOfWeek: string;
+    /** Tasks due today or currently in-progress. */
+    todayTasks: TaskEntry[];
+    /** Tasks past their due date and not done. */
+    overdueTasks: TaskEntry[];
+    /** Yesterday's journal (user + Ava entries). */
+    yesterdayJournal: JournalDay | null;
+    /** Recent memory entries (last 5, most relevant). */
+    recentMemories: MemoryEntry[];
+    /** Total active tasks (not archived/done). */
+    totalActiveTasks: number;
+    /** Tasks completed yesterday. */
+    completedYesterday: number;
+}
+/** The formatted briefing ready for display. */
+export interface Briefing {
+    /** The natural-language greeting text (markdown). */
+    text: string;
+    /** Raw data used to generate the briefing (for UI widgets). */
+    data: BriefingData;
+    /** When this briefing was generated (ISO 8601). */
+    generatedAt: string;
+}
+/** Persistent state to avoid repeating briefings. */
+export interface BriefingState {
+    /** Last date a briefing was shown (YYYY-MM-DD). */
+    lastBriefingDate: string | null;
+    /** Last time a briefing was shown (ISO 8601). */
+    lastBriefingAt: string | null;
+}
+//# sourceMappingURL=types.d.ts.map