@happyvertical/smrt-planner 0.57.6 → 0.57.8

package/dist/reports/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/lib/reports/planner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAYlE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/reports/planner.js

@@ -0,0 +1,60 @@
+/**
+ * The app's runtime reports: `createPlannerReports` over the planner's sample
+ * data, the recipes that are on and the sample clock. The assistant, the
+ * Saved reports page and a saved report's page all use one of these per
+ * data source.
+ */
+import { announceShellNavigation } from '@happyvertical/smrt-svelte/workspace';
+import { EPOCH } from "../data/fakes.js";
+import { plannerRuntime } from "../planner/instance.js";
+import { recipes } from "../recipes/index.js";
+import { recipeState } from "../recipes/state.svelte.js";
+import { createPlannerReports, reportPath, } from "./store.js";
+const bound = new WeakMap();
+/**
+ * Reports over `data`. Periods ("last month") are relative to the sample
+ * data's clock (`EPOCH`), as the overview charts are, so they find the rows
+ * the sample records carry.
+ */
+export function plannerReportsFor(data) {
+    let reports = bound.get(data);
+    if (!reports) {
+        reports = createPlannerReports({
+            data,
+            recipeIds: () => recipeState.ids,
+            recipes,
+            now: () => new Date(EPOCH),
+        });
+        bound.set(data, reports);
+    }
+    return reports;
+}
+/**
+ * After the person approved a report: open it under Saved reports, through
+ * the running app's own navigation (the static layout's router or a mounted
+ * planner's fragment). Unset, the confirmation card's link still reaches it.
+ */
+export async function openSavedReport(report) {
+    await plannerRuntime.openPath?.(reportPath(report.id));
+}
+/**
+ * Open a saved report, then announce the navigation from `from` (inside the
+ * dock) so the shell closes an overlaying dock and focuses the report's own
+ * heading. Announced only once the app's navigation has finished: a router
+ * that resets focus when it lands (SvelteKit's `goto`) would otherwise undo
+ * the shell's focus, most visibly when the report is already open.
+ */
+export async function openSavedReportFrom(from, report) {
+    try {
+        await openSavedReport(report);
+    }
+    catch {
+        // An aborted navigation still leaves the card's link to the report.
+    }
+    if (from?.isConnected) {
+        announceShellNavigation(from, {
+            // This report's own heading: never the page the person approved from.
+            focus: `[data-smrt-component="ReportDetail"][data-report-id="${CSS.escape(report.id)}"] h1`,
+        });
+    }
+}

package/dist/reports/sources.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Runtime report sources in the planner (#4100): the browser counterpart of a
+ * generated app's `packages.reports.runtime.sources`.
+ *
+ * A generated app lists its report sources in `smrt.config.ts`; the planner
+ * has no config, so it offers the models the app's menu shows (the nav entries
+ * of the recipes that are on), each described from the catalog. The in-memory
+ * runner (`@happyvertical/smrt-reports/spec`) evaluates specs over their sample
+ * rows. Nothing here is an authority boundary: it is sample data.
+ */
+import { type RuntimeReportMemorySource } from '@happyvertical/smrt-reports/spec';
+import type { CatalogModel } from '../catalog/types.ts';
+import { type Recipe } from '../recipes/index.ts';
+/** The RuntimeReport model saved reports are rows of. */
+export declare const RUNTIME_REPORT_MODEL = "@happyvertical/smrt-reports:RuntimeReport";
+/** The recipe that brings Reports (Saved reports). */
+export declare const REPORTS_RECIPE = "reports.runtime";
+/** A source the planner offers, with what the assistant needs to fill gaps. */
+export interface PlannerReportSource extends RuntimeReportMemorySource {
+    label: string;
+    /** The catalog model the rows come from. */
+    model: CatalogModel;
+    /** The natural date (smrt-reports' `defaultTimeField`), for ranking. */
+    dateField?: string;
+    /** The money field a "summary" or "total" sums by default. */
+    amountField?: string;
+}
+/** Describe one catalog model as an in-memory report source. */
+export declare function reportSourceFor(model: CatalogModel, label: string, id?: string): PlannerReportSource;
+/**
+ * The report sources of an app: one per model its menu lists (recipe nav
+ * entries of the recipes that are on), labelled as the menu labels it, in menu
+ * order. Saved reports themselves are never a source.
+ */
+export declare function plannerReportSources(recipeIds: readonly string[], recipes: readonly Recipe[]): PlannerReportSource[];
+//# sourceMappingURL=sources.d.ts.map

package/dist/reports/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../../src/lib/reports/sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGtE,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,qBAAqB,CAAC;AAE7D,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,8CAA8C,CAAC;AAEhF,sDAAsD;AACtD,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,+EAA+E;AAC/E,MAAM,WAAW,mBAAoB,SAAQ,yBAAyB;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,YAAY,CAAC;IACpB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiCD,gEAAgE;AAChE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,EACb,EAAE,SAAuB,GACxB,mBAAmB,CAyCrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,mBAAmB,EAAE,CA0BvB"}

package/dist/reports/sources.js

@@ -0,0 +1,125 @@
+/**
+ * Runtime report sources in the planner (#4100): the browser counterpart of a
+ * generated app's `packages.reports.runtime.sources`.
+ *
+ * A generated app lists its report sources in `smrt.config.ts`; the planner
+ * has no config, so it offers the models the app's menu shows (the nav entries
+ * of the recipes that are on), each described from the catalog. The in-memory
+ * runner (`@happyvertical/smrt-reports/spec`) evaluates specs over their sample
+ * rows. Nothing here is an authority boundary: it is sample data.
+ */
+import { describeRuntimeReportMemorySource, } from '@happyvertical/smrt-reports/spec';
+import { isMoneyField } from "../data/fakes.js";
+import { fieldLabel } from "../data/format.js";
+import { recipeNav } from "../recipes/index.js";
+/** The RuntimeReport model saved reports are rows of. */
+export const RUNTIME_REPORT_MODEL = '@happyvertical/smrt-reports:RuntimeReport';
+/** The recipe that brings Reports (Saved reports). */
+export const REPORTS_RECIPE = 'reports.runtime';
+function columnType(field) {
+    switch (field.type) {
+        case 'text':
+            return 'string';
+        case 'integer':
+            return 'integer';
+        case 'decimal':
+            return 'decimal';
+        case 'boolean':
+            return 'boolean';
+        case 'datetime':
+            return 'datetime';
+        case 'foreignKey':
+        case 'crossPackageRef':
+            return 'id';
+        default:
+            return null;
+    }
+}
+/** Snake-case plural of a class name: `TaxCode` -> `tax_codes`. */
+function sourceId(name) {
+    const snake = name.replace(/([a-z\d])([A-Z])/g, '$1_$2').toLowerCase();
+    if (/(series|species)$/.test(snake))
+        return snake;
+    if (/[^aeiou]y$/.test(snake))
+        return `${snake.slice(0, -1)}ies`;
+    if (/(s|x|z|ch|sh)$/.test(snake))
+        return `${snake}es`;
+    return `${snake}s`;
+}
+const PREFERRED_AMOUNTS = ['totalAmount', 'total', 'amount'];
+/** Describe one catalog model as an in-memory report source. */
+export function reportSourceFor(model, label, id = sourceId(model.name)) {
+    const schema = [{ name: 'id', type: 'string' }];
+    for (const field of model.fields) {
+        const type = columnType(field);
+        // System fields (tenant, snapshots, sync state) are framework plumbing;
+        // a person never reports on them.
+        if (!type || field.system || schema.some((f) => f.name === field.name)) {
+            continue;
+        }
+        // The catalog's field metadata is what smrt-reports reads its time and
+        // grouping hints from: `ui.format` ('money', 'date') and `enum`.
+        const format = isMoneyField(field)
+            ? 'money'
+            : type === 'datetime' && field.ui?.format === 'date'
+                ? 'date'
+                : undefined;
+        schema.push({
+            name: field.name,
+            type,
+            label: fieldLabel(field),
+            ...(format ? { format } : {}),
+            ...(type === 'string' && field.enum?.length ? { enum: field.enum } : {}),
+        });
+    }
+    const money = schema.filter((field) => field.format === 'money');
+    // Only a document's own total is "how much" by default; a customer's credit
+    // limit or a product's price is not, so those sources default to a count.
+    const amount = PREFERRED_AMOUNTS.map((name) => money.find((f) => f.name === name)).find(Boolean);
+    const source = {
+        id,
+        label,
+        ...(model.description ? { description: model.description } : {}),
+        schema,
+        model,
+        ...(amount ? { amountField: amount.name } : {}),
+    };
+    // The natural date comes from smrt-reports' descriptor, not a guess here.
+    const date = describeRuntimeReportMemorySource([source], id).defaultTimeField;
+    return date ? { ...source, dateField: date } : source;
+}
+/**
+ * The report sources of an app: one per model its menu lists (recipe nav
+ * entries of the recipes that are on), labelled as the menu labels it, in menu
+ * order. Saved reports themselves are never a source.
+ */
+export function plannerReportSources(recipeIds, recipes) {
+    const on = new Set(recipeIds);
+    const entries = new Map();
+    for (const recipe of recipes) {
+        if (!on.has(recipe.id))
+            continue;
+        for (const entry of recipeNav(recipe)) {
+            if (entry.model.id === RUNTIME_REPORT_MODEL)
+                continue;
+            entries.set(entry.model.id, [
+                ...(entries.get(entry.model.id) ?? []),
+                entry,
+            ]);
+        }
+    }
+    const seen = new Map();
+    const ids = new Set();
+    for (const [modelId, list] of entries) {
+        // A filtered entry ("Sales orders") shows part of the rows; the source is
+        // the whole model, so the unfiltered entry's label names it when there is one.
+        const entry = list.find((e) => !e.filter) ?? list[0];
+        let id = sourceId(entry.model.name);
+        // Two packages with one class name: keep both, told apart by package.
+        if (ids.has(id))
+            id = `${entry.packageId}.${id}`;
+        ids.add(id);
+        seen.set(modelId, reportSourceFor(entry.model, entry.label, id));
+    }
+    return [...seen.values()];
+}

package/dist/reports/store.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Runtime reports over the planner's sample data (#4100): the browser
+ * equivalent of a generated app's report tools and its confirmed save.
+ *
+ * - `sources()` is `reports.runtime.sources`: the app's menu models.
+ * - `define(intent)` is `reports.runtime.define` (preview): build the spec,
+ *   validate it with smrt-reports' own parser and run a preview with its
+ *   in-memory runner. It returns the same `awaiting_confirmation` proposal a
+ *   generated app returns; nothing is saved.
+ * - `save(proposal)` is the confirmed save (`saveRuntimeReport`): only a
+ *   person's approval calls it. It re-parses the spec, checks the hash and
+ *   runs it again against the current sources, then stores a RuntimeReport
+ *   row in the plan's sample data.
+ * - `client` is the `RuntimeReportsClient` smrt-reports' `SavedReports` and
+ *   `ReportDetail` read: list, get, run (afresh, every time), archive.
+ *
+ * Sample data carries no principal, tenant or permission, so none of this is
+ * an authority boundary; a generated app's server owns those.
+ */
+import { type RuntimeReportResult, type RuntimeReportSpec } from '@happyvertical/smrt-reports/spec';
+import type { ReportFieldInfo, ReportSourceInfo, RuntimeReportProposal, RuntimeReportsClient, SavedRuntimeReport } from '@happyvertical/smrt-reports/svelte';
+import type { DataSource } from '../data/source.ts';
+import type { Recipe } from '../recipes/types.ts';
+import { type ReportFollowUp, type ReportIntent } from './intent.ts';
+import { type PlannerReportSource } from './sources.ts';
+/** Who saves reports in the planner: there is one visitor and no accounts. */
+export declare const PLANNER_REPORT_AUTHOR = "planner";
+/** Where a generated app's confirmation posts; recorded on the proposal as there. */
+export declare const CONFIRM_PATH = "/api/_reports/runtime/confirm";
+/** The in-app path of a saved report (the RuntimeReport record page). */
+/** Saved reports, the RuntimeReport list. */
+export declare const REPORT_LIST_PATH = "/m/reports/RuntimeReport/";
+export declare function reportPath(id: string): string;
+export interface PlannerReportsOptions {
+    data: DataSource;
+    /** The recipes that are on now; the sources follow them. */
+    recipeIds: () => readonly string[];
+    recipes: readonly Recipe[];
+    /** The clock periods are relative to: the sample data's, so they hold rows. */
+    now: () => Date;
+}
+export type DefineResult = {
+    ok: true;
+    proposal: RuntimeReportProposal;
+    source: PlannerReportSource;
+} | {
+    ok: false;
+    question: string;
+    followUp?: ReportFollowUp;
+};
+export interface PlannerReports {
+    sources(): PlannerReportSource[];
+    /** `text` is what the person said; its time words fill gaps in the intent. */
+    define(intent: ReportIntent, text?: string): Promise<DefineResult>;
+    run(spec: RuntimeReportSpec): Promise<RuntimeReportResult>;
+    save(proposal: RuntimeReportProposal): Promise<SavedRuntimeReport>;
+    /** A source's described fields (labels, money format) for a confirmation card. */
+    fieldsFor(sourceId: string): ReportFieldInfo[];
+    /** Every offered source by label with its fields, for the report screens. */
+    sourceInfo(): ReportSourceInfo[];
+    client: RuntimeReportsClient;
+}
+export declare function createPlannerReports(options: PlannerReportsOptions): PlannerReports;
+//# sourceMappingURL=store.d.ts.map

package/dist/reports/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/lib/reports/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAIvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,cAAc,CAAC;AAEtB,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C,qFAAqF;AACrF,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAE5D,yEAAyE;AACzE,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAE5D,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GACpB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,qBAAqB,CAAC;IAChC,MAAM,EAAE,mBAAmB,CAAC;CAC7B,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACjC,8EAA8E;IAC9E,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnE,GAAG,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnE,kFAAkF;IAClF,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IAC/C,6EAA6E;IAC7E,UAAU,IAAI,gBAAgB,EAAE,CAAC;IACjC,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AA4CD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CA6JhB"}

package/dist/reports/store.js

@@ -0,0 +1,214 @@
+/**
+ * Runtime reports over the planner's sample data (#4100): the browser
+ * equivalent of a generated app's report tools and its confirmed save.
+ *
+ * - `sources()` is `reports.runtime.sources`: the app's menu models.
+ * - `define(intent)` is `reports.runtime.define` (preview): build the spec,
+ *   validate it with smrt-reports' own parser and run a preview with its
+ *   in-memory runner. It returns the same `awaiting_confirmation` proposal a
+ *   generated app returns; nothing is saved.
+ * - `save(proposal)` is the confirmed save (`saveRuntimeReport`): only a
+ *   person's approval calls it. It re-parses the spec, checks the hash and
+ *   runs it again against the current sources, then stores a RuntimeReport
+ *   row in the plan's sample data.
+ * - `client` is the `RuntimeReportsClient` smrt-reports' `SavedReports` and
+ *   `ReportDetail` read: list, get, run (afresh, every time), archive.
+ *
+ * Sample data carries no principal, tenant or permission, so none of this is
+ * an authority boundary; a generated app's server owns those.
+ */
+import { describeRuntimeReportMemorySource, parseRuntimeReportSpec, RuntimeReportError, runRuntimeReportInMemory, runtimeReportSpecDigest, serializeRuntimeReportSpec, } from '@happyvertical/smrt-reports/spec';
+import { getModelByQualifiedName } from "../catalog/index.js";
+import { questionForError, specFromIntent, } from "./intent.js";
+import { plannerReportSources, RUNTIME_REPORT_MODEL, } from "./sources.js";
+/** Who saves reports in the planner: there is one visitor and no accounts. */
+export const PLANNER_REPORT_AUTHOR = 'planner';
+/** Where a generated app's confirmation posts; recorded on the proposal as there. */
+export const CONFIRM_PATH = '/api/_reports/runtime/confirm';
+/** The in-app path of a saved report (the RuntimeReport record page). */
+/** Saved reports, the RuntimeReport list. */
+export const REPORT_LIST_PATH = '/m/reports/RuntimeReport/';
+export function reportPath(id) {
+    return `${REPORT_LIST_PATH}${encodeURIComponent(id)}/`;
+}
+/** A refusal shaped like the HTTP client's, so the components word it the same. */
+class PlannerReportError extends Error {
+    status;
+    code;
+    constructor(status, code) {
+        super(`Report request failed (${code})`);
+        this.status = status;
+        this.code = code;
+        this.name = 'PlannerReportError';
+    }
+}
+function reportModel() {
+    const found = getModelByQualifiedName(RUNTIME_REPORT_MODEL);
+    if (!found)
+        throw new Error(`${RUNTIME_REPORT_MODEL} is not in the catalog`);
+    return found.model;
+}
+/** A stored row as the browser projection; null when its spec no longer parses. */
+function savedFrom(row) {
+    if (typeof row.spec !== 'string')
+        return null;
+    let spec;
+    try {
+        spec = parseRuntimeReportSpec(row.spec);
+    }
+    catch {
+        return null;
+    }
+    return {
+        id: row.id,
+        title: spec.title,
+        ...(spec.description ? { description: spec.description } : {}),
+        sourceId: spec.source,
+        createdByUserId: typeof row.createdByUserId === 'string' ? row.createdByUserId : '',
+        status: row.status === 'archived' ? 'archived' : 'active',
+        spec,
+        ...(typeof row.createdAt === 'string' && row.createdAt
+            ? { savedAt: row.createdAt }
+            : {}),
+        canArchive: true,
+    };
+}
+export function createPlannerReports(options) {
+    const sources = () => plannerReportSources(options.recipeIds(), options.recipes);
+    /** `reports.runtime.run`: always against the sources and rows of now. */
+    async function run(spec) {
+        const offered = sources();
+        const source = offered.find((s) => s.id === spec.source);
+        const rows = source ? await options.data.list(source.model) : [];
+        // `ranAt` is when it really ran; periods use the sample clock in `define`.
+        return runRuntimeReportInMemory(spec, rows, { sources: offered });
+    }
+    async function define(intent, text = '') {
+        const built = specFromIntent(intent, sources(), options.now(), text);
+        if (!built.ok)
+            return built;
+        try {
+            const preview = await run(built.spec);
+            return {
+                ok: true,
+                source: built.source,
+                proposal: {
+                    status: 'awaiting_confirmation',
+                    specHash: preview.specHash,
+                    spec: built.spec,
+                    sourceLabel: built.source.label,
+                    confirmPath: CONFIRM_PATH,
+                    preview,
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof RuntimeReportError) {
+                return { ok: false, question: questionForError(error, built.source) };
+            }
+            throw error;
+        }
+    }
+    async function rows() {
+        const stored = await options.data.list(reportModel());
+        return stored.flatMap((row) => savedFrom(row) ?? []).reverse();
+    }
+    async function find(id) {
+        const row = await options.data.get(reportModel(), id);
+        const saved = row ? savedFrom(row) : null;
+        if (!saved)
+            throw new PlannerReportError(404, 'not_found');
+        return saved;
+    }
+    /** The confirmed save. Recomputes everything; the proposal carries no authority. */
+    async function save(proposal) {
+        let spec;
+        try {
+            spec = parseRuntimeReportSpec(proposal.spec);
+        }
+        catch {
+            throw new PlannerReportError(422, 'invalid_spec');
+        }
+        const specHash = await runtimeReportSpecDigest(spec);
+        if (specHash !== proposal.specHash) {
+            throw new PlannerReportError(422, 'spec_hash_mismatch');
+        }
+        // As a server recompiles for the confirming principal: the source and
+        // fields must still be offered now (a recipe may have been switched off).
+        try {
+            await run(spec);
+        }
+        catch (error) {
+            if (error instanceof RuntimeReportError) {
+                throw new PlannerReportError(422, error.code);
+            }
+            throw error;
+        }
+        const existing = (await rows()).find((report) => report.status === 'active' &&
+            report.createdByUserId === PLANNER_REPORT_AUTHOR &&
+            serializeRuntimeReportSpec(report.spec) ===
+                serializeRuntimeReportSpec(spec));
+        if (existing)
+            return existing; // A retry of the same approval saves once.
+        const row = await options.data.create(reportModel(), {
+            title: spec.title,
+            description: spec.description ?? '',
+            sourceId: spec.source,
+            spec: serializeRuntimeReportSpec(spec),
+            specHash,
+            status: 'active',
+            createdByUserId: PLANNER_REPORT_AUTHOR,
+            // When it was approved: real time, not the sample clock.
+            createdAt: new Date().toISOString(),
+        });
+        const saved = savedFrom(row);
+        if (!saved)
+            throw new PlannerReportError(500, 'invalid_result');
+        return saved;
+    }
+    const client = {
+        async list({ onlyMine, includeArchived }) {
+            return (await rows()).filter((report) => (includeArchived || report.status === 'active') &&
+                (!onlyMine || report.createdByUserId === PLANNER_REPORT_AUTHOR));
+        },
+        get: find,
+        async run(id) {
+            const report = await find(id);
+            if (report.status === 'archived') {
+                throw new PlannerReportError(409, 'report_archived');
+            }
+            return run(report.spec);
+        },
+        async archive(id, archived) {
+            await find(id);
+            await options.data.update(reportModel(), id, {
+                status: archived ? 'archived' : 'active',
+            });
+        },
+        confirm: save,
+    };
+    const fieldInfo = (fields) => fields.map(({ name, label, type, format }) => ({
+        name,
+        label,
+        type,
+        ...(format ? { format } : {}),
+    }));
+    function fieldsFor(sourceId) {
+        const offered = sources();
+        if (!offered.some((s) => s.id === sourceId))
+            return [];
+        return fieldInfo(describeRuntimeReportMemorySource(offered, sourceId).fields);
+    }
+    function sourceInfo() {
+        const offered = sources();
+        return offered.map((source) => {
+            const described = describeRuntimeReportMemorySource(offered, source.id);
+            return {
+                id: described.id,
+                label: described.label,
+                fields: fieldInfo(described.fields),
+            };
+        });
+    }
+    return { sources, define, run, save, client, fieldsFor, sourceInfo };
+}

package/dist/smrt-version.d.ts

@@ -1,3 +1,3 @@
 /** The released smrt line the planner is built against (the `smrt` CLI version its commands name). */
-export declare const SMRT_VERSION = "0.57.6";
+export declare const SMRT_VERSION = "0.57.8";
 //# sourceMappingURL=smrt-version.d.ts.map

package/dist/smrt-version.js

@@ -1,4 +1,4 @@
 // Generated by scripts/write-smrt-version.ts from the installed
 // @happyvertical/smrt-core; do not edit. `pnpm version:smrt` refreshes it.
 /** The released smrt line the planner is built against (the `smrt` CLI version its commands name). */
-export const SMRT_VERSION = '0.57.6';
+export const SMRT_VERSION = '0.57.8';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-planner",
-  "version": "0.57.6",
+  "version": "0.57.8",
   "type": "module",
   "description": "The smrt planner as a mountable Svelte component with a typed command set and plan snapshot.",
   "license": "MIT",
@@ -43,12 +43,13 @@
   },
   "dependencies": {
     "@happyvertical/ai": "^0.105.2",
-    "@happyvertical/smrt-assets": "0.57.6",
-    "@happyvertical/smrt-chat": "0.57.6",
-    "@happyvertical/smrt-commerce": "0.57.6",
-    "@happyvertical/smrt-core": "0.57.6",
-    "@happyvertical/smrt-svelte": "0.57.6",
-    "@happyvertical/smrt-ui": "0.57.6",
+    "@happyvertical/smrt-assets": "0.57.8",
+    "@happyvertical/smrt-chat": "0.57.8",
+    "@happyvertical/smrt-commerce": "0.57.8",
+    "@happyvertical/smrt-core": "0.57.8",
+    "@happyvertical/smrt-reports": "0.57.8",
+    "@happyvertical/smrt-svelte": "0.57.8",
+    "@happyvertical/smrt-ui": "0.57.8",
     "@happyvertical/speech": "^0.105.2",
     "@huggingface/transformers": "^4.3.0",
     "@mlc-ai/web-llm": "^0.2.85"
@@ -63,53 +64,52 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-ads": "0.57.6",
-    "@happyvertical/smrt-affiliates": "0.57.6",
-    "@happyvertical/smrt-agents": "0.57.6",
-    "@happyvertical/smrt-analytics": "0.57.6",
-    "@happyvertical/smrt-approvals": "0.57.6",
-    "@happyvertical/smrt-comments": "0.57.6",
-    "@happyvertical/smrt-content": "0.57.6",
-    "@happyvertical/smrt-education": "0.57.6",
-    "@happyvertical/smrt-events": "0.57.6",
-    "@happyvertical/smrt-expenses": "0.57.6",
-    "@happyvertical/smrt-facts": "0.57.6",
-    "@happyvertical/smrt-features": "0.57.6",
-    "@happyvertical/smrt-fields": "0.57.6",
-    "@happyvertical/smrt-gnode": "0.57.6",
-    "@happyvertical/smrt-human-resources": "0.57.6",
-    "@happyvertical/smrt-images": "0.57.6",
-    "@happyvertical/smrt-ingestion": "0.57.6",
-    "@happyvertical/smrt-inventory": "0.57.6",
-    "@happyvertical/smrt-jobs": "0.57.6",
-    "@happyvertical/smrt-languages": "0.57.6",
-    "@happyvertical/smrt-ledgers": "0.57.6",
-    "@happyvertical/smrt-manufacturing": "0.57.6",
-    "@happyvertical/smrt-marketing": "0.57.6",
-    "@happyvertical/smrt-messages": "0.57.6",
-    "@happyvertical/smrt-personas": "0.57.6",
-    "@happyvertical/smrt-places": "0.57.6",
-    "@happyvertical/smrt-playbooks": "0.57.6",
-    "@happyvertical/smrt-preferences": "0.57.6",
-    "@happyvertical/smrt-products": "0.57.6",
-    "@happyvertical/smrt-profiles": "0.57.6",
-    "@happyvertical/smrt-projects": "0.57.6",
-    "@happyvertical/smrt-prompts": "0.57.6",
-    "@happyvertical/smrt-properties": "0.57.6",
-    "@happyvertical/smrt-reports": "0.57.6",
-    "@happyvertical/smrt-sales": "0.57.6",
-    "@happyvertical/smrt-secrets": "0.57.6",
-    "@happyvertical/smrt-sites": "0.57.6",
-    "@happyvertical/smrt-social": "0.57.6",
-    "@happyvertical/smrt-subscriptions": "0.57.6",
-    "@happyvertical/smrt-support": "0.57.6",
-    "@happyvertical/smrt-tags": "0.57.6",
-    "@happyvertical/smrt-tenancy": "0.57.6",
-    "@happyvertical/smrt-timesheets": "0.57.6",
-    "@happyvertical/smrt-users": "0.57.6",
-    "@happyvertical/smrt-video": "0.57.6",
-    "@happyvertical/smrt-voice": "0.57.6",
-    "@happyvertical/smrt-webhooks": "0.57.6",
+    "@happyvertical/smrt-ads": "0.57.8",
+    "@happyvertical/smrt-affiliates": "0.57.8",
+    "@happyvertical/smrt-agents": "0.57.8",
+    "@happyvertical/smrt-analytics": "0.57.8",
+    "@happyvertical/smrt-approvals": "0.57.8",
+    "@happyvertical/smrt-comments": "0.57.8",
+    "@happyvertical/smrt-content": "0.57.8",
+    "@happyvertical/smrt-education": "0.57.8",
+    "@happyvertical/smrt-events": "0.57.8",
+    "@happyvertical/smrt-expenses": "0.57.8",
+    "@happyvertical/smrt-facts": "0.57.8",
+    "@happyvertical/smrt-features": "0.57.8",
+    "@happyvertical/smrt-fields": "0.57.8",
+    "@happyvertical/smrt-gnode": "0.57.8",
+    "@happyvertical/smrt-human-resources": "0.57.8",
+    "@happyvertical/smrt-images": "0.57.8",
+    "@happyvertical/smrt-ingestion": "0.57.8",
+    "@happyvertical/smrt-inventory": "0.57.8",
+    "@happyvertical/smrt-jobs": "0.57.8",
+    "@happyvertical/smrt-languages": "0.57.8",
+    "@happyvertical/smrt-ledgers": "0.57.8",
+    "@happyvertical/smrt-manufacturing": "0.57.8",
+    "@happyvertical/smrt-marketing": "0.57.8",
+    "@happyvertical/smrt-messages": "0.57.8",
+    "@happyvertical/smrt-personas": "0.57.8",
+    "@happyvertical/smrt-places": "0.57.8",
+    "@happyvertical/smrt-playbooks": "0.57.8",
+    "@happyvertical/smrt-preferences": "0.57.8",
+    "@happyvertical/smrt-products": "0.57.8",
+    "@happyvertical/smrt-profiles": "0.57.8",
+    "@happyvertical/smrt-projects": "0.57.8",
+    "@happyvertical/smrt-prompts": "0.57.8",
+    "@happyvertical/smrt-properties": "0.57.8",
+    "@happyvertical/smrt-sales": "0.57.8",
+    "@happyvertical/smrt-secrets": "0.57.8",
+    "@happyvertical/smrt-sites": "0.57.8",
+    "@happyvertical/smrt-social": "0.57.8",
+    "@happyvertical/smrt-subscriptions": "0.57.8",
+    "@happyvertical/smrt-support": "0.57.8",
+    "@happyvertical/smrt-tags": "0.57.8",
+    "@happyvertical/smrt-tenancy": "0.57.8",
+    "@happyvertical/smrt-timesheets": "0.57.8",
+    "@happyvertical/smrt-users": "0.57.8",
+    "@happyvertical/smrt-video": "0.57.8",
+    "@happyvertical/smrt-voice": "0.57.8",
+    "@happyvertical/smrt-webhooks": "0.57.8",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "2.70.3",
     "@sveltejs/package": "^3.0.0",