@withbuddi/buddi 0.1.0-pre.17 → 0.1.0-pre.19

package/packages/gateway/dist/missions/goals-format.js

@@ -6,7 +6,18 @@
  * other. Pure: numbers, dates, a timezone and two identifiers — no pool, no
  * registry, no clock of its own.
  */
-import { localDateString, progress, targetValue, } from '@buddi/core';
+import { addDays, frequencyWords, localDateString, progress, targetValue, isOwnerMetric, ownerMetricSource, } from '@buddi/core';
+/**
+ * The metric source every goal surface reads, with the owner's metrics in it.
+ *
+ * A source that already answers them (one `createGoalManifest` built) is used
+ * as it is, so the tools, the watcher and the page share one cache.
+ */
+export function asOwnerSource(source) {
+    return typeof source.refresh === 'function'
+        ? source
+        : ownerMetricSource(source);
+}
 /**
  * The watcher's id. Core's own, like the goals it reads.
  *
@@ -24,6 +35,21 @@ export function goalKey(goalId, event) {
 export function goalKeyPrefix(goalId) {
     return `goal.${goalId}.%`;
 }
+/** A metric's unit as its numbers are printed, or `number` for a metric nobody installed. */
+export function valueUnitOf(source, metric) {
+    const found = source.metric(metric);
+    if (found === undefined)
+        return 'number';
+    return isOwnerMetric(found) && found.unitLabel ? { unit: found.unit, label: found.unitLabel } : found.unit;
+}
+/** The enum, whichever shape the unit came in. */
+export function baseUnit(unit) {
+    return typeof unit === 'string' ? unit : unit.unit;
+}
+/** The owner's word for the unit, or null. */
+export function unitLabelOf(unit) {
+    return typeof unit === 'string' ? null : unit.label;
+}
 /**
  * A metric's number, in its own unit. Already formatted, like a Home stat.
  *
@@ -32,9 +58,14 @@ export function goalKeyPrefix(goalId) {
  * on a card the owner is about to approve, which is a worse answer than no
  * symbol at all: a missing symbol is visibly missing, a wrong one is not.
  */
-export function formatValue(value, unit, currency) {
+export function formatValue(value, valueUnit, currency) {
     if (value === null || !Number.isFinite(value))
         return 'not measured';
+    const label = unitLabelOf(valueUnit);
+    const bare = formatBare(value, baseUnit(valueUnit), currency);
+    return label === null ? bare : `${bare} ${label}`;
+}
+function formatBare(value, unit, currency) {
     if (unit === 'currency') {
         if (!currency)
             return new Intl.NumberFormat('en-US').format(round(value, 2));
@@ -72,11 +103,37 @@ export function formatPace(pace, unit, direction, currency) {
         return 'no time left';
     return `${formatValue(Math.abs(pace), unit, currency)} a week ${direction}`;
 }
+/**
+ * Where a frequency goal stands, in words: "2 of 3 this week, 1 to go by
+ * 2026-09-27; 4 weeks in a row". Past the deadline, the tally of windows.
+ */
+export function frequencyNow(goal, standing) {
+    if (goal.target.kind !== 'frequency')
+        return '';
+    const { count, per } = goal.target;
+    const streak = standing.streak > 0 ? `; ${standing.streak} ${per}${standing.streak === 1 ? '' : 's'} in a row` : '';
+    const current = standing.current;
+    if (current === null) {
+        // Partial windows that closed short are not windows the goal had.
+        const closed = standing.windows.filter((w) => w.state !== 'partial').length;
+        return `${standing.met} of ${closed} ${per}s met${streak}`;
+    }
+    const lastDay = addDays(current.end, -1);
+    const toGo = standing.toGo ?? 0;
+    return (`${current.count} of ${count} this ${per}` +
+        (toGo > 0 ? `, ${toGo} to go by ${lastDay}` : ', done') +
+        streak);
+}
 /** One goal, on one line: what `goal.list` prints and what a wake carries. */
 export function goalLine(goal, unit, last, timezone) {
     // The goal's own currency, not the last check's: an unmeasured check carries
     // none, and a line that loses its currency the week the bank is down is a
     // line that prints a different number than the week before.
+    if (goal.target.kind === 'frequency') {
+        // A frequency goal's last check carries its tally as the note.
+        return (`${goal.title} — ${frequencyWords(goal.target)} until ${localDateString(goal.deadline, timezone)}` +
+            `${last?.note ? ` (${last.note})` : ''}, checked ${goal.cadence}, held by @${goal.agentId}`);
+    }
     const currency = goal.currency ?? last?.currency ?? null;
     const at = last?.value ?? null;
     const pct = at === null ? null : progress(goal, at);

package/packages/gateway/dist/missions/goals-format.js.map

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

package/packages/gateway/dist/missions/goals-page.d.ts

@@ -19,8 +19,9 @@
  * `core.goal_checks` as the sentinel left them: a page that measured would be
  * a second, slower, unrecorded check happening whenever a tab is open.
  */
-import { type Goal, type GoalCheck, type GoalStanding, type HomeContribution, type MetricDirection, type MetricSource, type MetricUnit, type PageDescriptor, type PageQuery, type ToolDefinition, type ViewDescriptor } from '@buddi/core';
+import { type FrequencyStanding, type OwnerMetricValue, type Queryable, type Goal, type GoalCheck, type GoalStanding, type HomeContribution, type MetricDirection, type MetricSource, type PageDescriptor, type PageQuery, type ToolDefinition, type ViewDescriptor } from '@buddi/core';
 import { z } from 'zod';
+import { type ValueUnit } from './goals-format.js';
 /**
  * The caps every read on this page carries, in one place, because they are
  * promises the spec repeats: a screen is bounded or it is a way to ask the
@@ -38,6 +39,22 @@ export declare const MAX_GOALS_LISTED = 200;
 export declare const PAGE_CHECKS = 24;
 export declare const CHART_CHECKS = 500;
 export declare const MAX_FINDINGS = 20;
+/** The owner values a surface reads for one series: the newest this many. */
+export declare const OWNER_VALUES = 500;
+/**
+ * What a frequency goal's windows are counted over: every value since it was
+ * set, up to this many — three years of a few a day. A window must never read
+ * short because its values fell off the end of a read.
+ */
+export declare const FREQUENCY_VALUES = 5000;
+/**
+ * The values of the owner metric a goal watches, newest first, or none for a
+ * plugin metric. Read from the day before the goal was set, so a frequency
+ * goal's first window has everything it can count; capped, like every read.
+ */
+export declare function goalOwnerValues(db: Queryable, goal: Goal, sinceSet?: boolean): Promise<OwnerMetricValue[]>;
+/** A frequency goal's windows, from the owner's values. Null for any other goal. */
+export declare function frequencyOf(db: Queryable, goal: Goal, now: Date, timezone: string): Promise<FrequencyStanding | null>;
 /**
  * Where a goal stands, in the owner's words.
  *
@@ -60,7 +77,36 @@ export declare function standingTone(standing: GoalStanding, lastLookFailed: boo
  * a goal with no number has no progress and no pace, and a deadline already
  * past has no per-week left.
  */
-export declare function goalSub(goal: Goal, unit: MetricUnit, direction: MetricDirection, standing: GoalStanding, lastLookFailed: boolean, timezone: string): string;
+export declare function goalSub(goal: Goal, unit: ValueUnit, direction: MetricDirection, standing: GoalStanding, lastLookFailed: boolean, timezone: string): string;
+export declare function frequencyVerdict(standing: FrequencyStanding): GoalStanding['verdict'];
+export declare function frequencyWord(goal: Goal, standing: FrequencyStanding): string;
+export declare function frequencyTone(standing: FrequencyStanding): 'good' | 'critical' | 'neutral';
+/** The line under a frequency goal: the tally, then the verdict. */
+export declare function frequencySub(goal: Goal, standing: FrequencyStanding): string;
+/** The short figure beside it: this window's count against the target. */
+export declare function frequencyFigure(goal: Goal, standing: FrequencyStanding): string;
+/** One word for where a goal stands, the phone's vocabulary. */
+export type GoalDrift = 'on track' | 'behind' | 'ahead' | 'not measured';
+/** One open goal as `/goals` says it: its title, its number, one word. */
+export interface GoalDigestLine {
+    title: string;
+    /** The latest number, or this window's count against the target. */
+    figure: string;
+    drift: GoalDrift;
+}
+/**
+ * A level goal's word. Off track is "behind"; past the target already, or on
+ * track and well ahead of the calendar, is "ahead". With one number and no
+ * projection yet, the number against the calendar decides.
+ */
+export declare function levelDrift(standing: GoalStanding, elapsed: number): GoalDrift;
+/** A frequency goal's word: this window already met is "ahead"; the last whole one decides otherwise. */
+export declare function frequencyDrift(goal: Goal, standing: FrequencyStanding): GoalDrift;
+/**
+ * Every open goal, read the way Home reads them — the same checks, the same
+ * standing — and said in three parts. Read-only.
+ */
+export declare function goalDigest(db: Queryable, base: MetricSource, now: Date, timezone: string): Promise<GoalDigestLine[]>;
 /**
  * The Goals block: a line per open goal, and two figures.
  *
@@ -68,7 +114,7 @@ export declare function goalSub(goal: Goal, unit: MetricUnit, direction: MetricD
  * and "you have no goals" is a sentence the page does not need a card for. A
  * goal that has been met and closed is history, and history lives on the page.
  */
-export declare function createGoalHome(source: MetricSource): HomeContribution;
+export declare function createGoalHome(base: MetricSource): HomeContribution;
 /**
  * Both page queries, over one registry's metrics.
  *
@@ -76,7 +122,7 @@ export declare function createGoalHome(source: MetricSource): HomeContribution;
  * (`readOnlyPool`), so "a page cannot write" is enforced by Postgres rather
  * than promised here.
  */
-export declare function createGoalQueries(source: MetricSource): PageQuery[];
+export declare function createGoalQueries(base: MetricSource): PageQuery[];
 declare const ownerCloseInput: z.ZodObject<{
     id: z.ZodString;
     note: z.ZodString;
@@ -164,6 +210,15 @@ export interface GoalChart {
  * "where this has to be, and when" is the whole question, and a chart that
  * drew only the line would make the owner work it out.
  */
-export declare function chartOf(goal: Goal, unit: MetricUnit, direction: MetricDirection, checks: readonly GoalCheck[], timezone: string): GoalChart;
+export declare function chartOf(goal: Goal, unit: ValueUnit, direction: MetricDirection, checks: readonly GoalCheck[], timezone: string, 
+/**
+ * For a goal on an owner metric: the values the owner told buddi, which are
+ * the series itself — drawn as they were said, not as buddi looked at them —
+ * and, for a frequency goal, its windows, which are what it is judged on.
+ */
+owner?: {
+    values: readonly OwnerMetricValue[];
+    frequency: FrequencyStanding | null;
+} | null): GoalChart;
 export {};
 //# sourceMappingURL=goals-page.d.ts.map

package/packages/gateway/dist/missions/goals-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"goals-page.d.ts","sourceRoot":"","sources":["../../src/missions/goals-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAcL,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EAErB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EAGd,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,YAAY,KAAK,CAAC;AAyB/B;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,OAAO,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,OAAO,GACtB,MAAM,GAAG,UAAU,GAAG,SAAS,CAIjC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,OAAO,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CA6CrE;AA2BD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,EAAE,CAmKnE;AA6DD,QAAA,MAAM,eAAe;;;;;;;;;EAWV,CAAC;AAEZ;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,EAAE,OAAO,CAAC,CAwB/F;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE,cAiKvB,CAAC;AAMF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,EAAE,cAAc,EAerC,CAAC;AAEF,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,QAAQ,EAAE,MAAM,GACf,SAAS,CAqBX"}
+{"version":3,"file":"goals-page.d.ts","sourceRoot":"","sources":["../../src/missions/goals-page.ts"],"names":[],"mappings":"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"}