@cyc-seattle/platform 1.53.0 → 1.55.0

package/README.md

@@ -4,6 +4,9 @@ Pulumi stacks for CYC Community Sailing Center's shared Google Cloud platform: t
 app owns. The apps that run on it live in their own repos, such as
 [isthmia](https://github.com/cyc-seattle/isthmia).
 
+The [docs site](https://cyc-seattle.github.io/platform/) publishes [`docs/`](docs) from `main`: how the
+platform is built, its data model, and the planning engine.
+
 ## Stacks
 
 | Stack                           | Holds                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Applied by                                                                                                               |
@@ -101,20 +104,19 @@ deployer needs first.
 authenticates with Workload Identity Federation and stores no credentials. Each job runs in a
 GitHub environment that holds its identity and state bucket:
 
-| Event                      | Jobs, in order                                                          |
-| -------------------------- | ----------------------------------------------------------------------- |
-| Pull request               | `ci`                                                                    |
-| Merge queue                | `ci`, then `dev`: `mise run deploy` as `deploy-dev`; `dev-passed`       |
-| Push to `main`             | `prod-preview`, then `prod`, which waits for the `maintainers` approval |
-| Run by hand, from a branch | `ci`, then `dev`                                                        |
-| Run by hand, from `main`   | `prod-preview`, then `prod`                                             |
+| Event                    | Jobs, in order                                                          |
+| ------------------------ | ----------------------------------------------------------------------- |
+| Pull request             | `ci`                                                                    |
+| Merge queue              | `ci`, then `dev`: `mise run deploy` as `deploy-dev`; `dev-passed`       |
+| Push to `main`           | `prod-preview`, then `prod`, which waits for the `maintainers` approval |
+| Run by hand, from `main` | `prod-preview`, then `prod`                                             |
 
 Dev is shared, so only the merge queue deploys to it (#69, #80). PRs queued together deploy as
 one batch: each queued PR's run skips dev when a newer PR is queued behind it, and the newest
 deploys them all. The queue requires `dev-passed`, so a batch merges only once its dev deploy passes, and `main` gets the exact commit the queue tested, in one push. If the
 newest PR fails, the queue drops it and the rest of the batch deploys without it. A queued PR of only docs or CI skips `dev`. The queue
-doesn't run the integration tests (#161); a run by hand does. To try a
-branch on dev and test it before queueing it, run `gh workflow run pull-request.yml --ref <branch>`.
+doesn't run the integration tests (#161); a run by hand does. Dev's environment takes only `main`
+(#280), so a branch can't deploy to it.
 
 `prod-preview` runs `mise run preview` as `deploy-runner` and writes the diff to the job summary.
 `prod` runs `mise run deploy` on the same commit once approved. It runs only when the preview shows
@@ -164,9 +166,17 @@ login only when it isn't already set, so Actions' credentials win.
 mise run ci
 ```
 
-Runs the type check, Prettier, ESLint, and the unit tests. Tests mock Pulumi with
+Runs the type check, Prettier, ESLint, the unit tests, and the docs site's build. Tests mock Pulumi with
 `pulumi.runtime.setMocks` and never call a live API.
 
+```sh
+mise run docs-dev
+```
+
+Serves the docs site, from `docs-site/`, as you edit `docs/`. A page in `docs/` takes its title from
+its first heading, and a link to another file in the repo goes to GitHub. The build fails on a broken
+link. `.github/workflows/docs.yml` publishes it to GitHub Pages on every push to `main`.
+
 ```sh
 mise run integration
 ```

package/dist/planning/activities.js

@@ -8,7 +8,7 @@ export function scheduleActivities(ctx) {
     const closed = new Map();
     for (const c of ctx.data.plan_closed_dates ?? []) {
         // The closed days are the Operations Plan's, not an area's.
-        if (ctx.planOfVersion.get(c.version_id)?.kind === "program_area") {
+        if (ctx.planOf.get(c.plan_id)?.kind === "program_area") {
             ctx.warn("closed_date_in_area_plan", `${c.name} is a closed day in a Program Plan. Only the Operations Plan's closed days count`, c.key);
             continue;
         }
@@ -31,7 +31,7 @@ export function scheduleActivities(ctx) {
         const closedFor = closed.get(activity.date);
         if (closedFor !== undefined && activity.kind !== "travel") {
             ctx.warn("closed_date", `${offering.name}'s ${activity.kind} is on ${closedFor}, when ${ctx.data.organization.name} is closed`, activity.key, {
-                version_id: activity.version_id,
+                plan_id: activity.plan_id,
                 date: activity.date,
             });
         }

package/dist/planning/bonus.js

@@ -94,7 +94,7 @@ function areaOf(ctx, owner) {
  * order and then no term. An area plan's bonus counts only that area's products, and warns about any other.
  */
 function basesOf(ctx, owner, terms) {
-    const plan = ctx.planOfVersion.get(owner.version_id);
+    const plan = ctx.planOf.get(owner.plan_id);
     const products = new Set();
     for (const row of ctx.data.plan_bonus_owner_products) {
         if (row.bonus_owner_id !== owner.id)

package/dist/planning/context.d.ts

@@ -1,7 +1,7 @@
 import type { Account, AccountFunction, CostCenterType, CostType, DateString, EngineWarning, Id, PlanData, PlanOffering, Plan, PlanRates, Product, ProgramArea } from "./types.ts";
-/** Where a warning applies: a plan copy, and a date. */
+/** Where a warning applies: a plan, and a date. */
 export interface WarningScope {
-    version_id?: Id;
+    plan_id?: Id;
     date?: DateString;
 }
 /** The step that recorded an entry. Only `direct` entries count toward MTDC. */
@@ -31,8 +31,8 @@ export declare class Context {
     readonly accounts: Map<Id, Account>;
     readonly products: Map<Id, Product>;
     readonly areas: Map<Id, ProgramArea>;
-    /** Each version's plan. */
-    readonly planOfVersion: Map<Id, Plan>;
+    /** Each plan, by its id. */
+    readonly planOf: Map<Id, Plan>;
     readonly offeringsById: Map<Id, PlanOffering>;
     readonly offeringsByKey: Map<Id, PlanOffering>;
     /** Expected enrollment per offering id, which the costs and revenue use. */

package/dist/planning/context.js

@@ -24,8 +24,8 @@ export class Context {
     accounts;
     products;
     areas;
-    /** Each version's plan. */
-    planOfVersion;
+    /** Each plan, by its id. */
+    planOf;
     offeringsById;
     offeringsByKey;
     /** Expected enrollment per offering id, which the costs and revenue use. */
@@ -42,11 +42,7 @@ export class Context {
         this.accounts = new Map(data.accounts.map((a) => [a.id, a]));
         this.products = new Map(data.products.map((p) => [p.id, p]));
         this.areas = new Map(data.program_areas.map((a) => [a.id, a]));
-        const plans = new Map(data.plans.map((p) => [p.id, p]));
-        this.planOfVersion = new Map(data.plan_versions.flatMap((v) => {
-            const plan = plans.get(v.plan_id);
-            return plan === undefined ? [] : [[v.id, plan]];
-        }));
+        this.planOf = new Map(data.plans.map((p) => [p.id, p]));
         this.offeringsById = new Map(data.plan_offerings.map((o) => [o.id, o]));
         this.offeringsByKey = new Map(data.plan_offerings.map((o) => [o.key, o]));
         this.rates = data.plan_rates[0];
@@ -65,7 +61,7 @@ export class Context {
         return account;
     }
     warn(code, message, key, scope = {}) {
-        const same = (w) => w.code === code && w.message === message && w.version_id === scope.version_id;
+        const same = (w) => w.code === code && w.message === message && w.plan_id === scope.plan_id;
         if (this.warnings.some(same))
             return;
         const category = ALLOCATION_WARNINGS.has(code) ? "allocation" : "data";
@@ -74,7 +70,7 @@ export class Context {
             message,
             category,
             ...(key !== undefined && { key }),
-            ...(scope.version_id !== undefined && { version_id: scope.version_id }),
+            ...(scope.plan_id !== undefined && { plan_id: scope.plan_id }),
             ...(scope.date !== undefined && { date: scope.date }),
         });
     }

package/dist/planning/engine.js

@@ -127,7 +127,7 @@ function checkAreas(ctx) {
         else if (product.kind !== "program" && product.program_area_id != null) {
             ctx.warn("area_on_non_program", `${product.name} isn't a program but has a program area`, product.id);
         }
-        const plan = ctx.planOfVersion.get(offering.version_id);
+        const plan = ctx.planOf.get(offering.plan_id);
         if (plan === undefined)
             continue;
         const wrong = plan.kind === "operations"

package/dist/planning/lines.js

@@ -62,9 +62,9 @@ function checkCostCenter(ctx, type, key, line) {
  * organization already has its own warning, `capital_off_org`.
  */
 function warnCostShift(ctx, line) {
-    if (ctx.planOfVersion.get(line.version_id)?.kind !== "program_area")
+    if (ctx.planOf.get(line.plan_id)?.kind !== "program_area")
         return;
-    const warn = (message) => ctx.warn("cost_off_programs", message, line.key, { version_id: line.version_id });
+    const warn = (message) => ctx.warn("cost_off_programs", message, line.key, { plan_id: line.plan_id });
     const org = ctx.data.organization.name;
     const capital = ctx.accountType(line.account_id) === "asset";
     if (capital && line.cost_center_type === "org") {

package/dist/planning/salaried.js

@@ -34,12 +34,17 @@ export function bookSalaries(ctx, coaching, booker) {
                 }
                 return [
                     b.product_id != null
-                        ? { cost_center_type: "product", cost_center_key: b.product_id, hours: b.hours, line: b.kind }
+                        ? {
+                            cost_center_type: "product",
+                            cost_center_key: b.product_id,
+                            hours: b.hours,
+                            line: "management",
+                        }
                         : {
                             cost_center_type: "program_area",
                             cost_center_key: b.program_area_id,
                             hours: b.hours,
-                            line: b.kind,
+                            line: "management",
                         },
                 ];
             }),

package/dist/planning/staffing.d.ts

@@ -18,7 +18,7 @@ export interface DoubleBooked {
     /** Dates it's on two blocks at once. */
     dates: number;
 }
-/** Whole kids expected: `target_enrollment` if set, otherwise `capacity × fill_rate` rounded. */
+/** Whole kids expected: `target_enrollment`, or none when it's empty. */
 export declare function enrollmentOf(offering: PlanOffering): number;
 /** The most sailors an offering takes: its `capacity`, or else the sailors expected. */
 export declare function maxEnrollmentOf(offering: PlanOffering): number;
@@ -26,7 +26,7 @@ export declare class Staffing {
     private readonly ctx;
     private readonly warned;
     constructor(ctx: Context);
-    /** Warns once for each row and plan copy, about the first date it's seen on. */
+    /** Warns once for each row and plan, about the first date it's seen on. */
     private warnOnce;
     /**
      * Gathers each block's activities, times and allocations. A block's paid time runs from its first

package/dist/planning/staffing.js

@@ -1,8 +1,6 @@
-/** Whole kids expected: `target_enrollment` if set, otherwise `capacity × fill_rate` rounded. */
+/** Whole kids expected: `target_enrollment`, or none when it's empty. */
 export function enrollmentOf(offering) {
-    if (offering.target_enrollment != null)
-        return Math.round(offering.target_enrollment);
-    return Math.round((offering.capacity ?? 0) * (offering.fill_rate ?? 0));
+    return Math.round(offering.target_enrollment ?? 0);
 }
 /** The most sailors an offering takes: its `capacity`, or else the sailors expected. */
 export function maxEnrollmentOf(offering) {
@@ -51,9 +49,9 @@ export class Staffing {
     constructor(ctx) {
         this.ctx = ctx;
     }
-    /** Warns once for each row and plan copy, about the first date it's seen on. */
+    /** Warns once for each row and plan, about the first date it's seen on. */
     warnOnce(code, message, key, scope = {}) {
-        const id = `${code}|${key}|${scope.version_id ?? ""}`;
+        const id = `${code}|${key}|${scope.plan_id ?? ""}`;
         if (this.warned.has(id))
             return;
         this.warned.add(id);
@@ -80,7 +78,7 @@ export class Staffing {
                 continue;
             }
             if (row.date !== a.date) {
-                this.ctx.warn("block_date_mismatch", `${a.offering.name}'s ${a.kind} is in ${row.name}, which is on ${dayOf(row.date)}`, a.stored.key, { version_id: a.stored.version_id, date: a.date });
+                this.ctx.warn("block_date_mismatch", `${a.offering.name}'s ${a.kind} is in ${row.name}, which is on ${dayOf(row.date)}`, a.stored.key, { plan_id: a.stored.plan_id, date: a.date });
             }
             members.set(id, [...(members.get(id) ?? []), a]);
         }
@@ -125,7 +123,7 @@ export class Staffing {
             if (block !== undefined && sum(block.staff.map((s) => s.count)) > 0)
                 continue;
             this.ctx.warn("unallocated_activity", `${a.offering.name}'s ${a.kind} has no staff`, a.stored.key, {
-                version_id: a.stored.version_id,
+                plan_id: a.stored.plan_id,
                 date: a.date,
             });
         }
@@ -149,7 +147,7 @@ export class Staffing {
         const most = (o) => ctx.maxEnrollment.get(o.id) ?? 0;
         const sailors = sum(offerings.map(most));
         const warns = sailors > 0;
-        const scope = { version_id: block.row.version_id, date: block.row.date };
+        const scope = { plan_id: block.row.plan_id, date: block.row.date };
         // The block's offerings, with the verbs that agree with them: "Guppies Week 2 is for", "has".
         const several = new Set(block.members.map((a) => a.offering.id)).size > 1;
         const is = `${offeringsOf(block)} ${several ? "are" : "is"} for up to`;
@@ -161,7 +159,7 @@ export class Staffing {
             const settings = programs.get(o.product_id);
             if (settings?.staff_level_key == null || settings.sailors_per_coach == null || settings.sailors_per_coach <= 0) {
                 if (warns) {
-                    this.warnOnce("no_program_settings", `${o.name}'s program has no staff level or sailors per coach. Add both to check that it has enough coaches`, o.product_id, { version_id: o.version_id, date: block.row.date });
+                    this.warnOnce("no_program_settings", `${o.name}'s program has no staff level or sailors per coach. Add both to check that it has enough coaches`, o.product_id, { plan_id: o.plan_id, date: block.row.date });
                 }
                 continue;
             }
@@ -267,7 +265,7 @@ export class Staffing {
                 const rate = rates.get(id)?.charter_per_day_cents;
                 if (rate == null) {
                     for (const { block } of uses) {
-                        this.warnOnce("no_charter_rate", `${block.row.name} charters ${pluralOf(name)}, but the Operations Plan has no charter rate for them, so they cost nothing`, id, { version_id: block.row.version_id, date: block.row.date });
+                        this.warnOnce("no_charter_rate", `${block.row.name} charters ${pluralOf(name)}, but the Operations Plan has no charter rate for them, so they cost nothing`, id, { plan_id: block.row.plan_id, date: block.row.date });
                     }
                     continue;
                 }
@@ -305,9 +303,9 @@ export class Staffing {
                 const message = peak.at.length === 1
                     ? `${count} out at once for ${offeringsOf(peak.at[0].block)}, but ${organization} has ${only}`
                     : `${count} out at once, but ${organization} has ${only}: ${listOf(peak.at.map(({ block, n }) => `${n} for ${offeringsOf(block)}`))}`;
-                for (const version of new Set(peak.at.map(({ block }) => block.row.version_id))) {
+                for (const plan of new Set(peak.at.map(({ block }) => block.row.plan_id))) {
                     ctx.warn(code, message, what, {
-                        version_id: version,
+                        plan_id: plan,
                         date: date,
                     });
                 }
@@ -343,9 +341,9 @@ export class Staffing {
             const hours = extraCoachMinutes(list) / 60;
             const total = result.get(key) ?? { hours: 0, dates: 0 };
             result.set(key, { hours: total.hours + hours, dates: total.dates + 1 });
-            for (const version of new Set(list.map((b) => b.row.version_id))) {
+            for (const plan of new Set(list.map((b) => b.row.plan_id))) {
                 this.ctx.warn("position_double_booked", `${names.get(key) ?? key} coaches ${clash[0].row.name} and ${clash[1].row.name} at the same time` +
-                    (hours > 0 ? `, so another coach is needed for ${round2(hours)} hours` : ""), key, { version_id: version, date });
+                    (hours > 0 ? `, so another coach is needed for ${round2(hours)} hours` : ""), key, { plan_id: plan, date });
             }
         }
         return result;
@@ -370,7 +368,7 @@ export class Staffing {
         const given = new Map();
         const tripCoaches = new Map();
         for (const block of byDate(blocks)) {
-            const scope = { version_id: block.row.version_id, date: block.row.date };
+            const scope = { plan_id: block.row.plan_id, date: block.row.date };
             const paidHours = block.paid_minutes / 60;
             const waterHours = block.on_water_minutes / 60;
             const expected = this.coachesExpected(block, programs);
@@ -479,7 +477,7 @@ export class Staffing {
                     .filter(travel)
                     .map((a) => a.date)
                     .sort()[0];
-                this.warnOnce("trip_without_staff", `${trip.name} has no staff on its travel days, so the plan has no airfare or lodging for its coaches`, trip.key, { version_id: trip.version_id, ...(first !== undefined && { date: first }) });
+                this.warnOnce("trip_without_staff", `${trip.name} has no staff on its travel days, so the plan has no airfare or lodging for its coaches`, trip.key, { plan_id: trip.plan_id, ...(first !== undefined && { date: first }) });
             }
             const lodging = ctx.rates?.lodging_per_night_cents ?? null;
             const mileage = ctx.rates?.mileage_rate_cents ?? null;

package/dist/planning/types.d.ts

@@ -4,11 +4,11 @@ export type Id = string;
 export type DateString = string;
 /** A `time`, as `HH:MM` or `HH:MM:SS`. */
 export type TimeString = string;
-/** The columns every version-scoped row carries. */
-export interface Versioned {
+/** The columns every row of a plan carries. */
+export interface PlanRow {
     id: Id;
-    version_id: Id;
-    /** Stable across versions; references from other plans use it. */
+    plan_id: Id;
+    /** Stays the same when a Financial Plan is copied; references from other plans use it. */
     key: Id;
 }
 export type CostCenterType = "offering" | "product" | "program_area" | "pool" | "org";
@@ -94,13 +94,8 @@ export interface Plan {
     kind: "program_area" | "operations";
     program_area_id: Id | null;
 }
-/** A plan version. The engine reads only which plan it belongs to. */
-export interface PlanVersion {
-    id: Id;
-    plan_id: Id;
-}
 export type ActivityKind = "practice" | "regatta" | "clinic" | "travel";
-export interface PlanOffering extends Versioned {
+export interface PlanOffering extends PlanRow {
     product_id: Id;
     name: string;
     /** A `plan_terms` key in the Operations Plan, or none. */
@@ -109,23 +104,22 @@ export interface PlanOffering extends Versioned {
     ends_on: DateString;
     capacity: number | null;
     target_enrollment: number | null;
-    fill_rate: number | null;
     /** Per kid. */
     price_cents: number | null;
     cogs_rate: number | null;
     note: string | null;
 }
 /** A program's settings in a Program Plan: who coaches it, and how many sailors each coach takes. */
-export interface PlanProgram extends Versioned {
+export interface PlanProgram extends PlanRow {
     /** The program's product. */
     product_id: Id;
     /** A `plan_staff_levels` key. */
     staff_level_key: Id | null;
     sailors_per_coach: number | null;
-    /** The planner's own words, which only their AI reads. */
-    rules: string | null;
+    /** The planner's short notes, which only their AI reads. */
+    notes: string[] | null;
 }
-export interface PlanTrip extends Versioned {
+export interface PlanTrip extends PlanRow {
     offering_id: Id;
     name: string;
     nights: number | null;
@@ -134,7 +128,7 @@ export interface PlanTrip extends Versioned {
     miles: number | null;
 }
 /** One dated activity, or a travel day, as the planner or a scheduling tool entered it. */
-export interface PlanActivity extends Versioned {
+export interface PlanActivity extends PlanRow {
     offering_id: Id;
     /** The trip a travel day belongs to. */
     trip_id: Id | null;
@@ -150,12 +144,12 @@ export interface PlanActivity extends Versioned {
     block_id: Id | null;
 }
 /** Activities on one date that share their staff and boats. */
-export interface PlanActivityBlock extends Versioned {
+export interface PlanActivityBlock extends PlanRow {
     date: DateString;
     name: string;
 }
 /** Staff on a block: a number at one staff level, or a salaried position. */
-export interface PlanBlockStaff extends Versioned {
+export interface PlanBlockStaff extends PlanRow {
     block_id: Id;
     /** A `plan_staff_levels` key, for hourly or volunteer staff. */
     staff_level_key: Id | null;
@@ -166,14 +160,14 @@ export interface PlanBlockStaff extends Versioned {
     pay: "salary" | "hourly" | null;
 }
 /** Boats of one class on a block: the organization's, the ones it charters, and the ones sailors bring. */
-export interface PlanBlockBoats extends Versioned {
+export interface PlanBlockBoats extends PlanRow {
     block_id: Id;
     boat_class_id: Id;
     count: number;
     sailor_owned: number | null;
     chartered?: number | null;
 }
-export interface PlanLaborLine extends Versioned {
+export interface PlanLaborLine extends PlanRow {
     name: string;
     cost_center_type: CostCenterType;
     cost_center_key: Id | null;
@@ -184,7 +178,7 @@ export interface PlanLaborLine extends Versioned {
     function: AccountFunction | null;
     note: string | null;
 }
-export interface PlanBudgetLine extends Versioned {
+export interface PlanBudgetLine extends PlanRow {
     name: string;
     account_id: Id;
     function: AccountFunction | null;
@@ -200,7 +194,7 @@ export interface PlanBudgetLine extends Versioned {
  * Something lasting the Operations Plan means to buy, ranked by `sort` with the most needed first.
  * Its account is an asset account.
  */
-export interface PlanCapitalItem extends Versioned {
+export interface PlanCapitalItem extends PlanRow {
     name: string;
     amount_cents: number;
     account_id: Id;
@@ -208,19 +202,19 @@ export interface PlanCapitalItem extends Versioned {
     note?: string | null;
     link?: string | null;
 }
-/** The year's rates. An Operations plan version has at most one row. */
-export interface PlanRates extends Versioned {
+/** The year's rates. An Operations Plan has at most one row. */
+export interface PlanRates extends PlanRow {
     /** Employer payroll costs, as a share of wages. */
     payroll_tax_rate: number | null;
     lodging_per_night_cents: number | null;
     mileage_rate_cents: number | null;
 }
-export interface PlanStaffLevel extends Versioned {
+export interface PlanStaffLevel extends PlanRow {
     name: string;
     pay_type: "hourly" | "volunteer";
     hourly_rate_cents: number | null;
 }
-export interface PlanSalariedPosition extends Versioned {
+export interface PlanSalariedPosition extends PlanRow {
     name: string;
     annual_salary_cents: number;
     paid_hours_per_year: number | null;
@@ -231,15 +225,14 @@ export interface PlanSalariedPosition extends Versioned {
     hourly_coaching_rate_cents?: number | null;
 }
 /** Hours charged to a product, or to a program area and shared among its offerings: one of the two. */
-export interface PlanSalariedBooking extends Versioned {
+export interface PlanSalariedBooking extends PlanRow {
     position_id: Id;
     product_id: Id | null;
     program_area_id: Id | null;
-    kind: "management";
     hours: number;
 }
 /** A boat class's rates for the year. */
-export interface PlanBoatRate extends Versioned {
+export interface PlanBoatRate extends PlanRow {
     boat_class_id: Id;
     /** Upkeep for each hour one of the organization's boats of the class is on the water. */
     maintenance_per_boat_hour_cents: number;
@@ -249,10 +242,10 @@ export interface PlanBoatRate extends Versioned {
     charter_per_day_cents?: number | null;
 }
 /** A group of shared costs, such as G&A, divided among all of the plan's offerings by MTDC. */
-export interface PlanPool extends Versioned {
+export interface PlanPool extends PlanRow {
     name: string;
 }
-export interface PlanBonusOwner extends Versioned {
+export interface PlanBonusOwner extends PlanRow {
     role_name: string;
     bonus_rate: number;
     account_id: Id;
@@ -261,12 +254,12 @@ export interface PlanBonusOwner extends Versioned {
     /** A `plan_salaried_positions` key: the position the bonus pays. */
     position_key?: Id | null;
 }
-export interface PlanBonusOwnerProduct extends Versioned {
+export interface PlanBonusOwnerProduct extends PlanRow {
     bonus_owner_id: Id;
     product_id: Id;
 }
 /** A charge set as a share of each offering's revenue, such as scholarships or card fees. */
-export interface PlanRevenueCharge extends Versioned {
+export interface PlanRevenueCharge extends PlanRow {
     name: string;
     /** A share, such as 0.02 for 2%. */
     rate: number;
@@ -279,17 +272,17 @@ export interface PlanRevenueCharge extends Versioned {
     note: string | null;
 }
 /** A day the organization is closed, such as Labor Day. */
-export interface PlanClosedDate extends Versioned {
+export interface PlanClosedDate extends PlanRow {
     date: DateString;
     name: string;
 }
 /** A planning period in the Operations Plan, such as Summer 2027, which an offering can be in. */
-export interface PlanTerm extends Versioned {
+export interface PlanTerm extends PlanRow {
     name: string;
     starts_on: DateString;
     ends_on: DateString;
 }
-/** The catalog plus every row of the plan versions being calculated. */
+/** The catalog plus every row of the plans being calculated. */
 export interface PlanData {
     /** The plan year. Fiscal year N ends in calendar year N. */
     fiscal_year: number;
@@ -304,9 +297,8 @@ export interface PlanData {
     /** The asset list, with its boats, which the engine counts by class on each day. */
     assets: Asset[];
     boats: Boat[];
-    /** The plans and versions being calculated, so the engine can tell which plan each offering is in. */
+    /** The plans being calculated, so the engine can tell which plan each row is in. */
     plans: Plan[];
-    plan_versions: PlanVersion[];
     plan_programs: PlanProgram[];
     plan_offerings: PlanOffering[];
     plan_trips: PlanTrip[];
@@ -406,8 +398,8 @@ export interface EngineWarning {
     category: WarningCategory;
     /** The key of the row it's about, when there is one. */
     key?: string;
-    /** The plan copy it's about, when there is one. */
-    version_id?: Id;
+    /** The plan it's about, when there is one. */
+    plan_id?: Id;
     /** The date it's about, when there is one. */
     date?: DateString;
 }

package/dist/schema/index.d.ts

@@ -21,6 +21,7 @@ export interface Schema {
     clubspot_sessions: ClubspotSessions[];
     contact_points: ContactPoints[];
     contacts: Contacts[];
+    financial_plans: FinancialPlans[];
     google_group_memberships: GoogleGroupMemberships[];
     google_groups: GoogleGroups[];
     group_members: GroupMembers[];
@@ -61,7 +62,6 @@ export interface Schema {
     plan_staff_levels: PlanStaffLevels[];
     plan_terms: PlanTerms[];
     plan_trips: PlanTrips[];
-    plan_versions: PlanVersions[];
     plans: Plans[];
     products: Products[];
     program_area_role_assignments: ProgramAreaRoleAssignments[];
@@ -77,8 +77,6 @@ export interface Schema {
     sync_runs: SyncRuns[];
     sync_tasks: SyncTasks[];
     venues: Venues[];
-    version_set_members: VersionSetMembers[];
-    version_sets: VersionSets[];
     website_categories: WebsiteCategories[];
     website_categories_faq_topics: WebsiteCategoriesFaqTopics[];
     website_categories_files: WebsiteCategoriesFiles[];
@@ -147,6 +145,7 @@ export interface Assets {
     acquired_on: string | null;
     /** The day CSC sold, scrapped, or gave it away. Planning stops counting it on this day. Empty while CSC still has it. */
     disposed_on: string | null;
+    /** Up to 280 characters. Bold, italic, code and links work. */
     note: string | null;
 }
 /** Something a sync noticed but didn't fix. A dismissed finding stays dismissed on later runs. */
@@ -396,6 +395,36 @@ export interface Contacts {
     contact_order: number | null;
     relationship_detail: string | null;
 }
+/** The organization's plan for a year: an Operations Plan and a Program Plan for any of the program areas. Change it while it's a draft. Freezing it keeps it, and its plans, from changing. Pick a parent when you add one, and its plans are copied in. */
+export interface FinancialPlans {
+    id: string;
+    /** The organization the Financial Plan is for. */
+    organization_id: string | Organizations;
+    /** The year the Financial Plan is for. */
+    fiscal_year: number;
+    /** Such as 2027 budget as adopted. You can change it after it's frozen. */
+    name: string;
+    /** What it's for, such as "Reviewed with the board". Up to 280 characters. Bold, italic, code and links work. You can change it after it's frozen. */
+    note: string | null;
+    /** Set it to frozen to freeze the Financial Plan and its plans. A frozen one never changes, apart from its name, its note, the date it's active from, and whether it's archived. */
+    status: "draft" | "frozen";
+    /** The Financial Plan this one started as a copy of. Pick it when you add this one, and its plans are copied in. */
+    parent_id: string | FinancialPlans | null;
+    /** Set when the Financial Plan is frozen. */
+    frozen_by: string | null;
+    /** Set when the Financial Plan is frozen. */
+    frozen_at: string | null;
+    /** The version of the planning engine that calculated its numbers when it was frozen. */
+    platform_version: string | null;
+    /** The day the Financial Plan is in force from. Leave it empty for one that isn't active. On any day, the plan in force is the one for the year with the latest date on or before that day. A draft can be active. No two Financial Plans for a year can share a date. */
+    effective_from: string | null;
+    /** Set when the Financial Plan is archived, which hides it from Planning's list. Clear it to bring the plan back. The plan in force can't be archived. */
+    archived_at: string | null;
+    /** The organization's P&L. A draft's is worked out again a moment after each change to it. A frozen one's is worked out once, when it's frozen. One with none means working it out failed, and the logs say why. */
+    results: (string | PlanResults)[];
+    /** The plans it holds: one Operations Plan, and at most one Program Plan for each program area. Add or remove one only while it's a draft. */
+    plans: (string | Plans)[];
+}
 /** One row for each person the sync has seen in a program's Google Group. Set Removed at to stop the sync adding them back. Delete the row to let the sync add them again. */
 export interface GoogleGroupMemberships {
     id: string;
@@ -562,9 +591,9 @@ export interface People {
 /** One dated activity, such as a practice, a regatta day, or a travel day. */
 export interface PlanActivities {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     offering_id: string | PlanOfferings;
     /** The trip a travel day belongs to. */
@@ -583,9 +612,9 @@ export interface PlanActivities {
 /** Activities on one date that share their staff, RIBs and boats, such as Guppies and Minnows on the morning of July 13. */
 export interface PlanActivityBlocks {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     date: string;
     /** Such as Guppies and Minnows, morning. */
@@ -594,9 +623,9 @@ export interface PlanActivityBlocks {
 /** Boats of one class a block sails: the organization's, and the ones sailors bring. */
 export interface PlanBlockBoats {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     block_id: string | PlanActivityBlocks;
     boat_class_id: string | BoatClasses;
@@ -610,9 +639,9 @@ export interface PlanBlockBoats {
 /** Who coaches a block: a number of staff at one staff level, or a salaried position. */
 export interface PlanBlockStaff {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     block_id: string | PlanActivityBlocks;
     /** For staff at a staff level: copy the Key from a staff level in the Operations Plan. Leave it empty for a salaried position. */
@@ -627,9 +656,9 @@ export interface PlanBlockStaff {
 /** What an hour of sailing costs in maintenance, for each boat class. */
 export interface PlanBoatRates {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     boat_class_id: string | BoatClasses;
     /** Upkeep for each hour one of CSC's boats of the class is on the water. In cents: 12500 is $125.00. */
@@ -642,9 +671,9 @@ export interface PlanBoatRates {
 /** The products a bonus owner owns. */
 export interface PlanBonusOwnerProducts {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     bonus_owner_id: string | PlanBonusOwners;
     product_id: string | Products;
@@ -652,9 +681,9 @@ export interface PlanBonusOwnerProducts {
 /** A role, such as a program area's director, that earns a bonus on the products it owns. */
 export interface PlanBonusOwners {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     role_name: string;
     /** A share of its products' net. 0.05 means 5%. */
@@ -668,9 +697,9 @@ export interface PlanBonusOwners {
 /** A cost or revenue entered as an amount. */
 export interface PlanBudgetLines {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     name: string;
     account_id: string | Accounts;
@@ -683,14 +712,15 @@ export interface PlanBudgetLines {
     fiscal_year: number;
     /** Counts toward modified total direct costs (MTDC). Clear it for a cost 2 CFR 200.1 leaves out, such as equipment. */
     in_mtdc: boolean;
+    /** Up to 280 characters. Bold, italic, code and links work. */
     note: string | null;
 }
 /** Something lasting CSC means to buy, ranked with the most needed first. */
 export interface PlanCapitalItems {
     id: string;
-    /** The version this row belongs to. Capital goes in the Operations Plan's. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     /** What to buy, such as a coach boat. */
     name: string;
@@ -700,7 +730,7 @@ export interface PlanCapitalItems {
     account_id: string | Accounts;
     /** 1 is the most needed. Drag rows in the table to reorder them. */
     sort: number | null;
-    /** Why CSC needs it. */
+    /** Up to 280 characters. Bold, italic, code and links work. */
     note: string | null;
     /** A quote or listing for it, as a web address. */
     link: string | null;
@@ -708,9 +738,9 @@ export interface PlanCapitalItems {
 /** A day the organization is closed, such as Labor Day. The P&L warns about an activity on one. */
 export interface PlanClosedDates {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     date: string;
     /** Why it's closed, such as Labor Day. */
@@ -719,9 +749,9 @@ export interface PlanClosedDates {
 /** Labor not tied to an activity, such as training, priced at a staff level. */
 export interface PlanLaborLines {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     name: string;
     cost_center_type: "offering" | "product" | "program_area" | "pool" | "org";
@@ -732,14 +762,15 @@ export interface PlanLaborLines {
     hours: string;
     account_id: string | Accounts;
     function: "program" | "management" | "fundraising" | null;
+    /** Up to 280 characters. Bold, italic, code and links work. */
     note: string | null;
 }
 /** A product sold for a period, such as a season or a week. */
 export interface PlanOfferings {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     product_id: string | Products;
     name: string;
@@ -750,29 +781,28 @@ export interface PlanOfferings {
     capacity: number | null;
     /** Whole kids. Or set Fill rate instead. */
     target_enrollment: number | null;
-    /** A share of capacity, used when Target enrollment is empty. 0.8 means 80%. */
-    fill_rate: string | null;
     /** Per kid. In cents: 12500 is $125.00. */
     price_cents: number | null;
     /** Cost of goods sold, as a share of revenue. 0.1 means 10%. */
     cogs_rate: string | null;
+    /** Up to 280 characters. Bold, italic, code and links work. */
     note: string | null;
 }
 /** Shared costs no single offering owns, such as G&A, divided among the year's offerings by MTDC. */
 export interface PlanPools {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     name: string;
 }
-/** A program's settings in a Program Plan: the staff level that coaches it, how many sailors each coach can take, and its rules. */
+/** A program's settings in a Program Plan: the staff level that coaches it, how many sailors each coach can take, and its notes. */
 export interface PlanPrograms {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     /** The program. */
     product_id: string | Products;
@@ -780,15 +810,15 @@ export interface PlanPrograms {
     staff_level_key: string | null;
     /** How many sailors one coach at its staff level can safely take. */
     sailors_per_coach: string | null;
-    /** What you want for this program that its numbers don't capture, for your AI to follow. For example: if there are more than 12 Guppies, add a Junior Instructor. */
-    rules: string | null;
+    /** The program's rules, for your AI to follow in each of its offerings. Short notes, one a line, each up to 280 characters. Bold, italic, code and links work. */
+    notes: string[] | null;
 }
-/** The year's rates. One row at most in each copy. */
+/** The year's rates. One row at most in each plan. */
 export interface PlanRates {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     /** Employer payroll costs, as a share of wages. 0.1 means 10%. */
     payroll_tax_rate: string | null;
@@ -797,7 +827,7 @@ export interface PlanRates {
     /** In cents: 12500 is $125.00. */
     mileage_rate_cents: number | null;
 }
-/** Each bonus in a Financial Plan, for each term, and for the offerings in no term on the year. A draft's are worked out again a moment after each change to it, and a saved one's when it's saved, and then never change. */
+/** Each bonus in a Financial Plan, for each term, and for the offerings in no term on the year. A draft's are worked out again a moment after each change to it, and a frozen one's when it's frozen, and then never change. */
 export interface PlanResultBonuses {
     id: string;
     /** The bonus's role, such as Director. */
@@ -816,15 +846,15 @@ export interface PlanResultBonuses {
     bonus_owner_key: string;
     program_area_key: string | null;
     /** The Financial Plan these results are for. */
-    version_set_id: string | VersionSets;
-    /** The plan in the Financial Plan that pays the bonus. */
-    version_set_member_id: string | VersionSetMembers | null;
+    financial_plan_id: string | FinancialPlans;
+    /** The plan it's charged in, or about. */
+    plan_id: string | Plans | null;
 }
-/** The capital list in rank order, in a Financial Plan, with what the year's money covers. A draft's are worked out again a moment after each change to it, and a saved one's when it's saved, and then never change. */
+/** The capital list in rank order, in a Financial Plan, with what the year's money covers. A draft's are worked out again a moment after each change to it, and a frozen one's when it's frozen, and then never change. */
 export interface PlanResultCapital {
     id: string;
     /** The Financial Plan these results are for. */
-    version_set_id: string | VersionSets;
+    financial_plan_id: string | FinancialPlans;
     /** 1 is the most needed. */
     rank: number | null;
     item_key: string;
@@ -836,7 +866,7 @@ export interface PlanResultCapital {
     /** Whether what's left after operations and fundraising covers it, with everything ranked above it. */
     funded: boolean | null;
 }
-/** Each cost and revenue line in a Financial Plan's P&L. A draft's are worked out again a moment after each change to it, and a saved one's when it's saved, and then never change. */
+/** Each cost and revenue line in a Financial Plan's P&L. A draft's are worked out again a moment after each change to it, and a frozen one's when it's frozen, and then never change. */
 export interface PlanResultLines {
     id: string;
     cost_center_type: "offering" | "product" | "program_area" | "pool" | "org";
@@ -850,13 +880,13 @@ export interface PlanResultLines {
     line: string;
     explanation: string | null;
     /** The Financial Plan these results are for. */
-    version_set_id: string | VersionSets;
-    /** The plan in the Financial Plan that holds what it's charged to. */
-    version_set_member_id: string | VersionSetMembers | null;
+    financial_plan_id: string | FinancialPlans;
+    /** The plan it's charged in, or about. */
+    plan_id: string | Plans | null;
     /** What the line is, in plain words, such as G&A share: Payroll tax. */
     line_name: string | null;
 }
-/** A Financial Plan's P&L for each offering, product, and program area. A draft's are worked out again a moment after each change to it, and a saved one's when it's saved, and then never change. */
+/** A Financial Plan's P&L for each offering, product, and program area. A draft's are worked out again a moment after each change to it, and a frozen one's when it's frozen, and then never change. */
 export interface PlanResultPnl {
     id: string;
     level: "offering" | "product" | "program_area" | "program_area_term";
@@ -874,9 +904,9 @@ export interface PlanResultPnl {
     days: number;
     sailor_days: number;
     /** The Financial Plan these results are for. */
-    version_set_id: string | VersionSets;
-    /** The plan in the Financial Plan that holds what it's charged to. */
-    version_set_member_id: string | VersionSetMembers | null;
+    financial_plan_id: string | FinancialPlans;
+    /** The plan it's charged in, or about. */
+    plan_id: string | Plans | null;
     term_key: string | null;
     /** For a program area by term, the term. Empty for its offerings in no term, such as Adult Learn to Sail. */
     term_name: string | null;
@@ -887,7 +917,7 @@ export interface PlanResultPnl {
     /** The fewest sailors, up to its capacity, at which an offering pays for itself, with its share of shared costs as planned. Empty when it doesn't even when full, and for a product or program area. */
     breakeven_enrollment: number | null;
 }
-/** Each salaried position's pay for the year, in a Financial Plan. A draft's are worked out again a moment after each change to it, and a saved one's when it's saved, and then never change. */
+/** Each salaried position's pay for the year, in a Financial Plan. A draft's are worked out again a moment after each change to it, and a frozen one's when it's frozen, and then never change. */
 export interface PlanResultPositions {
     id: string;
     position_key: string;
@@ -910,13 +940,13 @@ export interface PlanResultPositions {
     /** The year's payroll tax on the total pay. In cents: 12500 is $125.00. */
     payroll_tax_cents: number;
     /** The Financial Plan these results are for. */
-    version_set_id: string | VersionSets;
+    financial_plan_id: string | FinancialPlans;
     /** Hours another coach would cover while this position coaches two or more groups at once: for three groups at once, two coaches. */
     double_booked_hours: string | null;
     /** Dates this position coaches two or more groups at once. */
     double_booked_dates: number | null;
 }
-/** What a Financial Plan's P&L warns about. A draft's are worked out again a moment after each change to it, and a saved one's when it's saved, and then never change. */
+/** What a Financial Plan's P&L warns about. A draft's are worked out again a moment after each change to it, and a frozen one's when it's frozen, and then never change. */
 export interface PlanResultWarnings {
     id: string;
     /** The kind of warning. */
@@ -924,15 +954,15 @@ export interface PlanResultWarnings {
     message: string;
     subject_key: string | null;
     /** The Financial Plan these results are for. */
-    version_set_id: string | VersionSets;
-    /** The plan in the Financial Plan it's about. */
-    version_set_member_id: string | VersionSetMembers | null;
+    financial_plan_id: string | FinancialPlans;
+    /** The plan it's charged in, or about. */
+    plan_id: string | Plans | null;
     /** The date it's about. */
     date: string | null;
     /** Allocation: the blocks break a limit, or run on a closed day. Data: a row is missing or wrong. */
     category: "allocation" | "data" | null;
 }
-/** A Financial Plan's totals for the organization. A draft's are worked out again a moment after each change to it, and a saved one's when it's saved, and then never change. */
+/** A Financial Plan's totals for the organization. A draft's are worked out again a moment after each change to it, and a frozen one's when it's frozen, and then never change. */
 export interface PlanResults {
     id: string;
     calculated_at: string;
@@ -953,14 +983,14 @@ export interface PlanResults {
     /** Operating net, plus fundraising net, less capital. In cents: 12500 is $125.00. */
     total_cents: number;
     /** The Financial Plan these results are for. */
-    version_set_id: string | VersionSets;
+    financial_plan_id: string | FinancialPlans;
 }
 /** A charge set as a share of each offering's revenue, such as scholarships or card fees. Operations Plan only. */
 export interface PlanRevenueCharges {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     name: string;
     /** The share of each offering's revenue: 0.02 means 2%. */
@@ -971,29 +1001,29 @@ export interface PlanRevenueCharges {
     account_id: string | Accounts;
     /** Counts toward MTDC. Clear it for a charge 2 CFR 200.1 leaves out, such as scholarships. */
     in_mtdc: boolean;
+    /** Up to 280 characters. Bold, italic, code and links work. */
     note: string | null;
 }
 /** Hours of a salaried position booked to a product. */
 export interface PlanSalariedBookings {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     position_id: string | PlanSalariedPositions;
     /** The product the hours are for. Set this or the program area, not both. */
     product_id: string | Products | null;
     /** The program area the hours are for, shared among its offerings. Set this or the product, not both. */
     program_area_id: string | ProgramAreas | null;
-    kind: "management";
     hours: string;
 }
 /** A salaried position, and where the part of its salary not charged to programs goes. */
 export interface PlanSalariedPositions {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     name: string;
     /** In cents: 12500 is $125.00. */
@@ -1009,9 +1039,9 @@ export interface PlanSalariedPositions {
 /** A level hourly staff are paid at, such as head coach. */
 export interface PlanStaffLevels {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     name: string;
     pay_type: "hourly" | "volunteer";
@@ -1021,9 +1051,9 @@ export interface PlanStaffLevels {
 /** A planning period, such as Summer 2027, with its start and end dates. An offering in a Program Plan can be in one of its Financial Plan's terms. */
 export interface PlanTerms {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     /** What it's called, such as Summer 2027. */
     name: string;
@@ -1035,9 +1065,9 @@ export interface PlanTerms {
 /** A trip an offering travels for, such as an away regatta. */
 export interface PlanTrips {
     id: string;
-    /** The version this row belongs to. */
-    version_id: string | PlanVersions;
-    /** Stays the same across versions. Copy it where another row asks for this one's Key. */
+    /** The plan this row belongs to. */
+    plan_id: string | Plans;
+    /** Stays the same when a Financial Plan is copied. Copy it where another row asks for this one's Key. */
     key: string;
     offering_id: string | PlanOfferings;
     name: string;
@@ -1046,38 +1076,16 @@ export interface PlanTrips {
     airfare_cents: number | null;
     miles: number | null;
 }
-/** One plan's copy in one Financial Plan, with every row it holds. It's saved with its Financial Plan, and then never changes. */
-export interface PlanVersions {
-    id: string;
-    plan_id: string | Plans;
-    /** The copy this one was made from, in the Financial Plan this one's started from. */
-    parent_version_id: string | PlanVersions | null;
-    /** Saved with its Financial Plan. A saved copy never changes, even for an admin. */
-    status: "draft" | "saved";
-    /** What changed in this version. */
-    message: string | null;
-    /** Set when its Financial Plan is saved. */
-    saved_by: string | null;
-    /** Set when its Financial Plan is saved. */
-    saved_at: string | null;
-    /** The version of the planning engine that calculated its numbers. Required to save. */
-    platform_version: string | null;
-    /** What you want that the plan's numbers don't capture, for your AI to fill in. For example: every Monday, Wednesday and Friday, except on SPS school holidays, from 4pm until dusk. */
-    rules: string | null;
-}
-/** One part of a Financial Plan: a program area's Program Plan, or the Operations Plan. */
+/** One part of a Financial Plan, with every row it holds: a program area's Program Plan, or the Operations Plan. */
 export interface Plans {
     id: string;
+    /** What you want that the plan's numbers don't capture, for your AI to fill in. Short notes, one a line, each up to 280 characters. Bold, italic, code and links work. */
+    notes: string[] | null;
+    /** The Financial Plan it's part of. It can't move to another. */
+    financial_plan_id: string | FinancialPlans;
     kind: "program_area" | "operations";
     /** The program area the plan is for. Empty for the Operations Plan. */
     program_area_id: string | ProgramAreas | null;
-    /** The organization the plan is for. Can't change once the plan has a saved copy. */
-    organization_id: string | Organizations;
-    /** The plan year. Fiscal year N ends in calendar year N. Can't change once the plan has a saved copy. */
-    fiscal_year: number;
-    name: string;
-    /** The plan's copy in each Financial Plan. */
-    versions: (string | PlanVersions)[];
 }
 /** A lasting thing the club sells. A program also has a row in Programs. */
 export interface Products {
@@ -1226,45 +1234,6 @@ export interface Venues {
     /** Other names it goes by, such as on a regatta's notice of race. */
     aliases: string[] | null;
 }
-/** One plan in a Financial Plan: the copy of the plan it holds. Add or remove one only while the Financial Plan is a draft. */
-export interface VersionSetMembers {
-    id: string;
-    version_set_id: string | VersionSets;
-    /** Filled in from the plan copy. */
-    plan_id: string | Plans | null;
-    /** The plan's copy in this Financial Plan. It's in no other Financial Plan. */
-    version_id: string | PlanVersions;
-}
-/** The organization's plan for a year: one Operations Plan, and a Program Plan for any of the program areas, with the P&L they make together. Change its plans while it's a draft. Its P&L is worked out again a moment after each change. Saving it saves them all, and then it never changes, apart from its name and note. Pick a parent when you add one, and its plans are copied in. */
-export interface VersionSets {
-    id: string;
-    /** The organization the Financial Plan is for. */
-    organization_id: string | Organizations;
-    /** The year the Financial Plan is for. */
-    fiscal_year: number;
-    /** Such as 2027 budget as adopted. You can change it after it's saved. */
-    name: string;
-    /** What it was for, such as "Reviewed with the board". You can change it after it's saved. */
-    message: string | null;
-    /** Set it to saved to save the Financial Plan and all its plans. A saved Financial Plan never changes, apart from its name, its note, the date it's active from, and whether it's archived. */
-    status: "draft" | "saved";
-    /** The Financial Plan this one started as a copy of. Pick it when you add this one, and its plans are copied in. */
-    parent_id: string | VersionSets | null;
-    /** Set when the Financial Plan is saved. */
-    saved_by: string | null;
-    /** Set when the Financial Plan is saved. */
-    saved_at: string | null;
-    /** The version of the planning engine that calculated its numbers. */
-    platform_version: string | null;
-    /** The day the Financial Plan is in force from. Leave it empty for one that isn't active. On any day, the plan in force is the one for the year with the latest date on or before that day. A draft can be active. No two Financial Plans for a year can share a date. */
-    effective_from: string | null;
-    /** Set when the Financial Plan is archived, which hides it from Planning's list. Clear it to bring the plan back. The plan in force can't be archived. */
-    archived_at: string | null;
-    /** Each plan in the Financial Plan. Add or remove one only while it's a draft. */
-    members: (string | VersionSetMembers)[];
-    /** The organization's P&L. A draft's is worked out again a moment after each change to it. A saved one's is what it showed when it was saved, worked out a moment after. One with none means working it out failed, and the logs say why. An admin can fill in a saved one's. */
-    results: (string | PlanResults)[];
-}
 /** Program categories, such as Summer Sailing Camps, each with a page at /program-category/ and its slug. */
 export interface WebsiteCategories {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyc-seattle/platform",
-  "version": "1.53.0",
+  "version": "1.55.0",
   "description": "Pulumi components for CYC's shared Google Cloud platform: WebService, the platform outputs reader, and the stacks that build the platform",
   "author": "CYC Community Sailing Center",
   "license": "Apache-2.0",
@@ -81,6 +81,7 @@
     "@types/js-yaml": "4.0.9",
     "@types/luxon": "^3.7.6",
     "@types/node": "^22.19.1",
+    "commander": "13.1.0",
     "esbuild": "0.28.2",
     "eslint": "^9.39.5",
     "google-auth-library": "^11.3.0",