projectionlab-mcp 1.0.1 → 1.2.0

package/dist/largeOutput.js

@@ -1,3 +1,4 @@
+import { readdir, stat, unlink } from "node:fs/promises";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { toJson } from "./json.js";
@@ -5,6 +6,28 @@ import { secureMkdir, secureWriteFile } from "./secureFs.js";
 import { log } from "./logger.js";
 export const FILE_THRESHOLD = 100_000;
 export const EXPORT_DIR = join(homedir(), ".projectionlab-mcp", "exports");
+const RETENTION_DAYS = 30;
+/** Delete export files whose last modification is older than the retention
+ * window. Only .json files this module writes are touched. */
+async function prune() {
+    const cutoff = Date.now() - RETENTION_DAYS * 24 * 60 * 60 * 1000;
+    const files = await readdir(EXPORT_DIR);
+    for (const file of files) {
+        if (!file.endsWith(".json"))
+            continue;
+        const filePath = join(EXPORT_DIR, file);
+        try {
+            const info = await stat(filePath);
+            if (info.mtimeMs < cutoff) {
+                await unlink(filePath);
+                log.info("largeOutput", `Pruned expired export ${file}`);
+            }
+        }
+        catch {
+            // Skip unreadable files.
+        }
+    }
+}
 /**
  * Returns the text as-is when small enough; otherwise writes it to a file
  * and returns a pointer message so MCP clients don't truncate mid-JSON.
@@ -17,6 +40,8 @@ export async function textOrFile(text, label, summary = {}) {
     const filePath = join(EXPORT_DIR, `${label}-${timestamp}.json`);
     await secureWriteFile(filePath, text);
     log.info("largeOutput", `Wrote ${text.length} chars to ${filePath}`);
+    // Prune expired exports in the background, the way snapshots do.
+    prune().catch((err) => log.warn("largeOutput", `Prune failed: ${err}`));
     return toJson({
         truncated: true,
         reason: `Result is ${text.length} chars, larger than the ${FILE_THRESHOLD} char inline limit`,

package/dist/largeOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"largeOutput.js","sourceRoot":"","sources":["../src/largeOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,KAAa,EACb,UAAmC,EAAE;IAErC,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,SAAS,OAAO,CAAC,CAAC;IAChE,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,MAAM,aAAa,QAAQ,EAAE,CAAC,CAAC;IAErE,OAAO,MAAM,CACX;QACE,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,aAAa,IAAI,CAAC,MAAM,2BAA2B,cAAc,oBAAoB;QAC7F,QAAQ;QACR,IAAI,EAAE,8DAA8D;QACpE,GAAG,OAAO;KACX,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"largeOutput.js","sourceRoot":"","sources":["../src/largeOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC;AAC3E,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B;8DAC8D;AAC9D,KAAK,UAAU,KAAK;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC;gBAC1B,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACvB,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,KAAa,EACb,UAAmC,EAAE;IAErC,IAAI,IAAI,CAAC,MAAM,IAAI,cAAc;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,SAAS,OAAO,CAAC,CAAC;IAChE,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,MAAM,aAAa,QAAQ,EAAE,CAAC,CAAC;IAErE,iEAAiE;IACjE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,GAAG,EAAE,CAAC,CAAC,CAAC;IAExE,OAAO,MAAM,CACX;QACE,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,aAAa,IAAI,CAAC,MAAM,2BAA2B,cAAc,oBAAoB;QAC7F,QAAQ;QACR,IAAI,EAAE,8DAA8D;QACpE,GAAG,OAAO;KACX,CACF,CAAC;AACJ,CAAC"}

package/dist/logger.js

@@ -1,25 +1,32 @@
 import { config } from "./config.js";
+import { redactSecrets } from "./redact.js";
 const LEVELS = { error: 0, warn: 1, info: 2, debug: 3 };
 const threshold = LEVELS[config.logLevel] ?? LEVELS.info;
 function timestamp() {
     return new Date().toISOString();
 }
+// Messages often carry an error from the browser executor, which can echo
+// request data. Every line is scrubbed here so no call site can log the
+// Plugin API key.
+function write(label, op, msg) {
+    console.error(`[${timestamp()}] ${label} [${op}] ${redactSecrets(msg)}`);
+}
 export const log = {
     error(op, msg) {
         if (threshold >= LEVELS.error)
-            console.error(`[${timestamp()}] ERROR [${op}] ${msg}`);
+            write("ERROR", op, msg);
     },
     warn(op, msg) {
         if (threshold >= LEVELS.warn)
-            console.error(`[${timestamp()}] WARN  [${op}] ${msg}`);
+            write("WARN ", op, msg);
     },
     info(op, msg) {
         if (threshold >= LEVELS.info)
-            console.error(`[${timestamp()}] INFO  [${op}] ${msg}`);
+            write("INFO ", op, msg);
     },
     debug(op, msg) {
         if (threshold >= LEVELS.debug)
-            console.error(`[${timestamp()}] DEBUG [${op}] ${msg}`);
+            write("DEBUG", op, msg);
     },
 };
 //# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAEjE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;AAEzD,SAAS,SAAS;IAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,CAAC,EAAU,EAAE,GAAW;QAC3B,IAAI,SAAS,IAAI,MAAM,CAAC,KAAK;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,YAAY,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,EAAU,EAAE,GAAW;QAC1B,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI;YAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,YAAY,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,EAAU,EAAE,GAAW;QAC1B,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI;YAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,YAAY,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,KAAK,CAAC,EAAU,EAAE,GAAW;QAC3B,IAAI,SAAS,IAAI,MAAM,CAAC,KAAK;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,YAAY,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAEjE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;AAEzD,SAAS,SAAS;IAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,0EAA0E;AAC1E,wEAAwE;AACxE,kBAAkB;AAClB,SAAS,KAAK,CAAC,KAAa,EAAE,EAAU,EAAE,GAAW;IACnD,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,KAAK,KAAK,KAAK,EAAE,KAAK,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,CAAC,EAAU,EAAE,GAAW;QAC3B,IAAI,SAAS,IAAI,MAAM,CAAC,KAAK;YAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,EAAU,EAAE,GAAW;QAC1B,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI;YAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,EAAU,EAAE,GAAW;QAC1B,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI;YAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,KAAK,CAAC,EAAU,EAAE,GAAW;QAC3B,IAAI,SAAS,IAAI,MAAM,CAAC,KAAK;YAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;CACF,CAAC"}

package/dist/pathPatch.d.ts

@@ -24,9 +24,12 @@ export interface AddressableValueOptions {
 export declare function listAddressableValues(data: unknown, prefix?: string, options?: AddressableValueOptions): AddressableValue[];
 /**
  * Apply path-addressed changes immutably. Paths must already exist and values
- * must retain their JSON type.
+ * must retain their JSON type. When `scope` names a group in the data model
+ * registry (a settings section, event section, or Current Finances
+ * collection), a string value outside an observed enum's choices is refused
+ * with INVALID_INPUT.
  */
-export declare function applyExistingPathChanges(data: unknown, incoming: Record<string, unknown>, context: PathPatchContext): {
+export declare function applyExistingPathChanges(data: unknown, incoming: Record<string, unknown>, context: PathPatchContext, scope?: string): {
     updated: PlanObj;
     changes: Record<string, PathValueChange>;
 };

package/dist/pathPatch.js

@@ -1,3 +1,4 @@
+import { enumRefusalError } from "./dataModel.js";
 import { ProjectionLabError } from "./errors.js";
 import { isSecretFieldName } from "./redact.js";
 const UNSAFE_PATH_SEGMENTS = new Set(["__proto__", "prototype", "constructor"]);
@@ -97,6 +98,11 @@ function assertCompatibleType(path, current, incoming, context) {
 }
 function replaceAtPath(root, parts, incoming, fullPath, context) {
     const [head, ...tail] = parts;
+    // "length" is an own property of arrays, so hasOwnProperty alone would let
+    // a leaf patch resize the array through copy[Number("length")].
+    if (Array.isArray(root) && !/^(0|[1-9]\d*)$/.test(head)) {
+        throw new ProjectionLabError("INVALID_INPUT", `Array segment "${head}" in ${context.label} path "${fullPath}" is not an index`, `Use a numeric array index returned by ${context.discoveryTool}`);
+    }
     if (!Object.prototype.hasOwnProperty.call(root, head)) {
         throw new ProjectionLabError("INVALID_INPUT", `Unknown ${context.label} path "${fullPath}"`, `Only existing paths returned by ${context.discoveryTool} can be changed`);
     }
@@ -127,9 +133,12 @@ function replaceAtPath(root, parts, incoming, fullPath, context) {
 }
 /**
  * Apply path-addressed changes immutably. Paths must already exist and values
- * must retain their JSON type.
+ * must retain their JSON type. When `scope` names a group in the data model
+ * registry (a settings section, event section, or Current Finances
+ * collection), a string value outside an observed enum's choices is refused
+ * with INVALID_INPUT.
  */
-export function applyExistingPathChanges(data, incoming, context) {
+export function applyExistingPathChanges(data, incoming, context, scope) {
     if (!isPlainObject(data)) {
         throw new ProjectionLabError("INVALID_INPUT", `The selected ${context.label} container is not an object`, `Inspect it with ${context.discoveryTool}`);
     }
@@ -148,6 +157,11 @@ export function applyExistingPathChanges(data, incoming, context) {
     const changes = {};
     for (const [path, after] of Object.entries(incoming)) {
         const parts = parsePath(path, context);
+        if (scope !== undefined) {
+            const refusal = enumRefusalError(scope, path, after);
+            if (refusal)
+                throw refusal;
+        }
         let before = data;
         for (const part of parts) {
             if (!isContainer(before) ||

package/dist/pathPatch.js.map

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

package/dist/planSettings.d.ts

@@ -4,7 +4,7 @@ export type PlanSettingSection = (typeof PLAN_SETTING_SECTIONS)[number];
 export type PlanSetting = AddressableValue;
 export type PlanSettingChange = PathValueChange;
 export declare function listPlanSettings(sectionData: unknown, section?: PlanSettingSection): PlanSetting[];
-export declare function applyPlanSettingChanges(sectionData: unknown, incoming: Record<string, unknown>): {
+export declare function applyPlanSettingChanges(sectionData: unknown, incoming: Record<string, unknown>, section?: PlanSettingSection): {
     updated: Record<string, unknown>;
     changes: Record<string, PlanSettingChange>;
 };

package/dist/planSettings.js

@@ -14,15 +14,15 @@ const ADVANCED_RATE_SCHEDULES = new Set([
 const PLAN_SETTING_CONTEXT = {
     label: "plan setting",
     discoveryTool: "projectionlab_get_plan_settings",
-    example: '{ "inflation": 0.03 }',
+    example: '{ "inflation": 3 }',
 };
 export function listPlanSettings(sectionData, section) {
     return listAddressableValues(sectionData, "", section === "variables"
         ? { expandArrayPaths: ADVANCED_RATE_SCHEDULES }
         : {});
 }
-export function applyPlanSettingChanges(sectionData, incoming) {
-    return applyExistingPathChanges(sectionData, incoming, PLAN_SETTING_CONTEXT);
+export function applyPlanSettingChanges(sectionData, incoming, section) {
+    return applyExistingPathChanges(sectionData, incoming, PLAN_SETTING_CONTEXT, section);
 }
 export function planSettingChangesApplied(sectionData, expected) {
     return pathChangesApplied(sectionData, expected, PLAN_SETTING_CONTEXT);

package/dist/planSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"planSettings.js","sourceRoot":"","sources":["../src/planSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW;IACX,YAAY;IACZ,oBAAoB;CACZ,CAAC;AAMX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,iBAAiB;IACjB,wBAAwB;IACxB,oBAAoB;IACpB,4BAA4B;IAC5B,wBAAwB;CACzB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,cAAc;IACrB,aAAa,EAAE,iCAAiC;IAChD,OAAO,EAAE,uBAAuB;CACxB,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAC9B,WAAoB,EACpB,OAA4B;IAE5B,OAAO,qBAAqB,CAC1B,WAAW,EACX,EAAE,EACF,OAAO,KAAK,WAAW;QACrB,CAAC,CAAC,EAAE,gBAAgB,EAAE,uBAAuB,EAAE;QAC/C,CAAC,CAAC,EAAE,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,WAAoB,EACpB,QAAiC;IAKjC,OAAO,wBAAwB,CAC7B,WAAW,EACX,QAAQ,EACR,oBAAoB,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAAoB,EACpB,QAA2C;IAE3C,OAAO,kBAAkB,CAAC,WAAW,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AACzE,CAAC"}
+{"version":3,"file":"planSettings.js","sourceRoot":"","sources":["../src/planSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW;IACX,YAAY;IACZ,oBAAoB;CACZ,CAAC;AAMX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,iBAAiB;IACjB,wBAAwB;IACxB,oBAAoB;IACpB,4BAA4B;IAC5B,wBAAwB;CACzB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,cAAc;IACrB,aAAa,EAAE,iCAAiC;IAChD,OAAO,EAAE,oBAAoB;CACrB,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAC9B,WAAoB,EACpB,OAA4B;IAE5B,OAAO,qBAAqB,CAC1B,WAAW,EACX,EAAE,EACF,OAAO,KAAK,WAAW;QACrB,CAAC,CAAC,EAAE,gBAAgB,EAAE,uBAAuB,EAAE;QAC/C,CAAC,CAAC,EAAE,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,WAAoB,EACpB,QAAiC,EACjC,OAA4B;IAK5B,OAAO,wBAAwB,CAC7B,WAAW,EACX,QAAQ,EACR,oBAAoB,EACpB,OAAO,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAAoB,EACpB,QAA2C;IAE3C,OAAO,kBAAkB,CAAC,WAAW,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AACzE,CAAC"}

package/dist/plans.d.ts

@@ -2,13 +2,34 @@ import { ProjectionLabError } from "./errors.js";
 export type PlanObj = Record<string, unknown>;
 export declare const PLAN_SECTIONS: readonly ["income", "expenses", "accounts", "assets", "milestones", "variables", "withdrawalStrategy", "montecarlo", "priorities"];
 export type PlanSection = (typeof PLAN_SECTIONS)[number];
+/** Sections whose members are events addressed by id or name; the
+ * settings-like sections use projectionlab_update_plan_settings instead. */
+export declare const EVENT_SECTIONS: readonly ["income", "expenses", "accounts", "assets", "milestones", "priorities"];
+/** The container each section holds, known from its name alone and not from
+ * what a plan happens to store: milestones is a direct array, the event
+ * sections are objects with an events array, and the settings-like sections
+ * are plain objects. Per DATA-MODEL.md sections 5.1 to 5.6 and the
+ * `variables`, `montecarlo` and `withdrawalStrategy` field trees. */
+export declare const SECTION_CONTAINERS: {
+    readonly income: "events";
+    readonly expenses: "events";
+    readonly accounts: "events";
+    readonly assets: "events";
+    readonly milestones: "array";
+    readonly variables: "object";
+    readonly withdrawalStrategy: "object";
+    readonly montecarlo: "object";
+    readonly priorities: "events";
+};
 /**
- * Find a plan by identifier. Match priority: exact ID, exact name
- * (case-insensitive), then partial name. Exact matches win over partial so
- * plans with shared name prefixes can't be silently confused on write paths.
+ * Index of the plan the identifier names, -1 when nothing matches. Throws
+ * INVALID_INPUT when several plans match the same way, so a read and the
+ * following write can never target different plans.
  */
-export declare function findPlanIndex(plans: unknown[], identifier: string): number;
-export declare function findPlan(plans: unknown[], identifier: string): PlanObj | null;
+export declare function resolvePlanIndex(plans: unknown[], identifier: string): number;
+/** The plan the identifier names, or null when nothing matches. Refuses
+ * ambiguous identifiers the way resolvePlanIndex does. */
+export declare function resolvePlan(plans: unknown[], identifier: string): PlanObj | null;
 export declare function planNotFoundError(plans: unknown[], identifier: string): ProjectionLabError;
 export declare function requirePlans(data: {
     plans?: unknown[];
@@ -24,14 +45,38 @@ export declare function planEventCounts(plan: unknown): {
     expenseCount: number;
     milestoneCount: number;
 };
-/** Index of the event matching `identifier`: exact id, then exact name (case-insensitive), then name substring. -1 if none. */
-export declare function findEventIndex(events: unknown[], identifier: string): number;
+/**
+ * Index of the event the identifier names: exact id, then exact name
+ * (case-insensitive), then name substring. -1 when nothing matches. Throws
+ * INVALID_INPUT when several events match the same way.
+ */
+export declare function resolveEventIndex(events: unknown[], identifier: string): number;
 export declare function eventLabel(event: unknown): string;
 /**
- * True when every leaf value in `expected` is present and equal in `actual`.
- * Tolerates fields ProjectionLab adds on its own (e.g. generated IDs) but
- * catches dropped or changed values. Arrays must match in length and order.
+ * Key events for diffing by label plus occurrence number, so events sharing a
+ * name each keep their own entry. Ids are not used because a replacement
+ * section may omit them. The display name shows the occurrence only when the
+ * label repeats.
+ */
+export declare function keyEvents(events: unknown[]): Map<string, {
+    name: string;
+    event: unknown;
+}>;
+/** The container kind of a section value, or null when it is not a usable
+ * container (null, undefined, a primitive, or a non-plain object). */
+export declare function sectionContainer(value: unknown): "array" | "events" | "object" | null;
+/**
+ * Refuse sectionData whose container shape does not match the section named.
+ * The expected container comes from the section's name, not from what the
+ * plan currently stores, so an event section held as {} still accepts the
+ * correct { events: [...] } replacement. One exception: when the stored
+ * section is itself a usable container that contradicts the table, a
+ * replacement in the stored shape is accepted too, so the tool never refuses
+ * to write back what it just read. An omitted value would delete the
+ * section, and a container of the wrong kind would store data ProjectionLab
+ * cannot read.
  */
+export declare function assertSectionShape(section: string, planName: string, current: unknown, incoming: unknown): void;
 /**
  * True when every value in `expected` is present and equal in `actual`.
  * Objects may carry extra keys; arrays must match in length and order.
@@ -49,5 +94,23 @@ export declare function verifySectionApplied(submitted: unknown, actual: unknown
     ok: boolean;
     reason?: string;
 };
+/**
+ * True when `after` still holds every input value of `before`.
+ * `lastUpdated`, `simKey`, and `meta` are left out: ProjectionLab saves every
+ * plan on array replacement and re-runs simulations, which may re-stamp
+ * lastUpdated and update computed fields (simKey, meta.runKey,
+ * meta.yearlySummary) on untouched plans.
+ */
+export declare function samePlanContent(before: PlanObj, after: PlanObj): boolean;
+/**
+ * Checks on a plan a write did not target, beyond its input content: its
+ * `lastUpdated` stamp may move forward (restorePlans saves every plan) but may
+ * not go backwards or disappear, and a `simKey` it carried may change value
+ * (ProjectionLab re-runs the plan open in the tab) but may not disappear. A
+ * plan that carried no simKey, or a stamp that is not a number on either side,
+ * is not reported, so absent fields never read as a change. `label` names the
+ * plan in each problem, for example `original plan p1`.
+ */
+export declare function keptPlanIdentityProblems(label: string, before: PlanObj, after: PlanObj): string[];
 /** Field-by-field diff of two objects; values rendered as "from → to". */
 export declare function diffFields(current: unknown, incoming: unknown): Record<string, string>;

package/dist/plans.js

@@ -10,34 +10,93 @@ export const PLAN_SECTIONS = [
     "montecarlo",
     "priorities",
 ];
+/** Sections whose members are events addressed by id or name; the
+ * settings-like sections use projectionlab_update_plan_settings instead. */
+export const EVENT_SECTIONS = [
+    "income",
+    "expenses",
+    "accounts",
+    "assets",
+    "milestones",
+    "priorities",
+];
+/** The container each section holds, known from its name alone and not from
+ * what a plan happens to store: milestones is a direct array, the event
+ * sections are objects with an events array, and the settings-like sections
+ * are plain objects. Per DATA-MODEL.md sections 5.1 to 5.6 and the
+ * `variables`, `montecarlo` and `withdrawalStrategy` field trees. */
+export const SECTION_CONTAINERS = {
+    income: "events",
+    expenses: "events",
+    accounts: "events",
+    assets: "events",
+    milestones: "array",
+    variables: "object",
+    withdrawalStrategy: "object",
+    montecarlo: "object",
+    priorities: "events",
+};
 /**
- * Find a plan by identifier. Match priority: exact ID, exact name
- * (case-insensitive), then partial name. Exact matches win over partial so
- * plans with shared name prefixes can't be silently confused on write paths.
+ * Resolve one identifier against a list of { id, name } items. Match
+ * priority: exact ID, then exact name (case-insensitive), then name
+ * substring. Anything beyond a single match at the level reached is
+ * ambiguous: picking the first would silently target whichever item happens
+ * to come first, so the caller must refuse and ask for an exact name or ID.
  */
-export function findPlanIndex(plans, identifier) {
+function matchOne(items, identifier) {
     if (!identifier.trim())
-        return -1;
+        return { kind: "none" };
     const lower = identifier.toLowerCase();
-    let exactName = -1;
-    let partial = -1;
-    for (let i = 0; i < plans.length; i++) {
-        const plan = plans[i];
-        if (!plan || typeof plan !== "object")
+    const exact = [];
+    const partial = [];
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        if (!item || typeof item !== "object")
             continue;
-        const obj = plan;
+        const obj = item;
         if (String(obj.id ?? "") === identifier)
-            return i;
+            return { kind: "found", index: i };
         const name = String(obj.name ?? "").toLowerCase();
-        if (name === lower && exactName === -1)
-            exactName = i;
-        else if (name.includes(lower) && partial === -1)
-            partial = i;
+        if (name === lower)
+            exact.push(i);
+        else if (name.includes(lower))
+            partial.push(i);
+    }
+    if (exact.length === 1)
+        return { kind: "found", index: exact[0] };
+    if (exact.length > 1)
+        return { kind: "ambiguous", indexes: exact };
+    if (partial.length === 1)
+        return { kind: "found", index: partial[0] };
+    if (partial.length > 1)
+        return { kind: "ambiguous", indexes: partial };
+    return { kind: "none" };
+}
+function ambiguousMatchError(kind, identifier, items, indexes) {
+    const candidates = indexes
+        .map((i) => {
+        const obj = items[i];
+        return `  - "${obj.name ?? "(unnamed)"}" (ID: ${obj.id ?? "?"})`;
+    })
+        .join("\n");
+    return new ProjectionLabError("INVALID_INPUT", `More than one ${kind} matches "${identifier}"`, `Candidates:\n${candidates}\nSupply an exact name or one of the IDs`);
+}
+/**
+ * Index of the plan the identifier names, -1 when nothing matches. Throws
+ * INVALID_INPUT when several plans match the same way, so a read and the
+ * following write can never target different plans.
+ */
+export function resolvePlanIndex(plans, identifier) {
+    const outcome = matchOne(plans, identifier);
+    if (outcome.kind === "ambiguous") {
+        throw ambiguousMatchError("plan", identifier, plans, outcome.indexes);
     }
-    return exactName !== -1 ? exactName : partial;
+    return outcome.kind === "found" ? outcome.index : -1;
 }
-export function findPlan(plans, identifier) {
-    const i = findPlanIndex(plans, identifier);
+/** The plan the identifier names, or null when nothing matches. Refuses
+ * ambiguous identifiers the way resolvePlanIndex does. */
+export function resolvePlan(plans, identifier) {
+    const i = resolvePlanIndex(plans, identifier);
     return i === -1 ? null : plans[i];
 }
 export function planNotFoundError(plans, identifier) {
@@ -87,27 +146,17 @@ function eventId(event) {
     }
     return undefined;
 }
-/** Index of the event matching `identifier`: exact id, then exact name (case-insensitive), then name substring. -1 if none. */
-export function findEventIndex(events, identifier) {
-    if (!identifier.trim())
-        return -1;
-    const lower = identifier.toLowerCase();
-    let exactName = -1;
-    let partial = -1;
-    for (let i = 0; i < events.length; i++) {
-        const e = events[i];
-        if (!e || typeof e !== "object")
-            continue;
-        const obj = e;
-        if (String(obj.id ?? "") === identifier)
-            return i;
-        const name = String(obj.name ?? "").toLowerCase();
-        if (name === lower && exactName === -1)
-            exactName = i;
-        else if (name.includes(lower) && partial === -1)
-            partial = i;
+/**
+ * Index of the event the identifier names: exact id, then exact name
+ * (case-insensitive), then name substring. -1 when nothing matches. Throws
+ * INVALID_INPUT when several events match the same way.
+ */
+export function resolveEventIndex(events, identifier) {
+    const outcome = matchOne(events, identifier);
+    if (outcome.kind === "ambiguous") {
+        throw ambiguousMatchError("event", identifier, events, outcome.indexes);
     }
-    return exactName !== -1 ? exactName : partial;
+    return outcome.kind === "found" ? outcome.index : -1;
 }
 export function eventLabel(event) {
     if (event && typeof event === "object") {
@@ -116,6 +165,30 @@ export function eventLabel(event) {
     }
     return "unnamed";
 }
+/**
+ * Key events for diffing by label plus occurrence number, so events sharing a
+ * name each keep their own entry. Ids are not used because a replacement
+ * section may omit them. The display name shows the occurrence only when the
+ * label repeats.
+ */
+export function keyEvents(events) {
+    const labelCounts = new Map();
+    for (const e of events) {
+        const label = eventLabel(e);
+        labelCounts.set(label, (labelCounts.get(label) ?? 0) + 1);
+    }
+    const seen = new Map();
+    const keyed = new Map();
+    for (const e of events) {
+        const label = eventLabel(e);
+        const n = (seen.get(label) ?? 0) + 1;
+        seen.set(label, n);
+        const key = `${label}#${n}`;
+        const name = (labelCounts.get(label) ?? 0) > 1 ? `${label} #${n}` : label;
+        keyed.set(key, { name, event: e });
+    }
+    return keyed;
+}
 function sectionIsEventBased(section) {
     if (Array.isArray(section))
         return true;
@@ -123,11 +196,59 @@ function sectionIsEventBased(section) {
         typeof section === "object" &&
         Array.isArray(section.events));
 }
+function isPlainSectionObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/** The container kind of a section value, or null when it is not a usable
+ * container (null, undefined, a primitive, or a non-plain object). */
+export function sectionContainer(value) {
+    if (Array.isArray(value))
+        return "array";
+    if (isPlainSectionObject(value)) {
+        return Array.isArray(value.events) ? "events" : "object";
+    }
+    return null;
+}
+const CONTAINER_WORDS = {
+    array: "an array of events",
+    events: "an object with an events array",
+    object: "an object",
+};
 /**
- * True when every leaf value in `expected` is present and equal in `actual`.
- * Tolerates fields ProjectionLab adds on its own (e.g. generated IDs) but
- * catches dropped or changed values. Arrays must match in length and order.
+ * Refuse sectionData whose container shape does not match the section named.
+ * The expected container comes from the section's name, not from what the
+ * plan currently stores, so an event section held as {} still accepts the
+ * correct { events: [...] } replacement. One exception: when the stored
+ * section is itself a usable container that contradicts the table, a
+ * replacement in the stored shape is accepted too, so the tool never refuses
+ * to write back what it just read. An omitted value would delete the
+ * section, and a container of the wrong kind would store data ProjectionLab
+ * cannot read.
  */
+export function assertSectionShape(section, planName, current, incoming) {
+    const incomingShape = sectionContainer(incoming);
+    if (incomingShape === null) {
+        const got = incoming === undefined
+            ? "missing"
+            : incoming === null
+                ? "null"
+                : Array.isArray(incoming)
+                    ? "an array"
+                    : typeof incoming;
+        throw new ProjectionLabError("INVALID_INPUT", `sectionData for "${section}" of plan "${planName}" is ${got}; a section is ${CONTAINER_WORDS.array} or ${CONTAINER_WORDS.object}`, "Send the complete section in the same shape projectionlab_get_plan_section returns: an array for milestones, an object with an events array for event sections, an object for settings-like sections");
+    }
+    const expected = SECTION_CONTAINERS[section];
+    const accepted = new Set([expected]);
+    const currentShape = sectionContainer(current);
+    if (currentShape !== null && currentShape !== expected)
+        accepted.add(currentShape);
+    if (!accepted.has(incomingShape)) {
+        throw new ProjectionLabError("INVALID_INPUT", `sectionData for "${section}" of plan "${planName}" must be ${CONTAINER_WORDS[expected]}, which is how this section is stored; received ${CONTAINER_WORDS[incomingShape]}`, `Read the section with projectionlab_get_plan_section and send the replacement in the container shape the section name calls for`);
+    }
+}
 /**
  * True when every value in `expected` is present and equal in `actual`.
  * Objects may carry extra keys; arrays must match in length and order.
@@ -191,6 +312,49 @@ export function verifySectionApplied(submitted, actual) {
     }
     return { ok: true };
 }
+/**
+ * True when `after` still holds every input value of `before`.
+ * `lastUpdated`, `simKey`, and `meta` are left out: ProjectionLab saves every
+ * plan on array replacement and re-runs simulations, which may re-stamp
+ * lastUpdated and update computed fields (simKey, meta.runKey,
+ * meta.yearlySummary) on untouched plans.
+ */
+export function samePlanContent(before, after) {
+    const { lastUpdated: _stamp, simKey: _key, meta: _meta, ...content } = before;
+    return containsSubset(content, after);
+}
+/**
+ * Checks on a plan a write did not target, beyond its input content: its
+ * `lastUpdated` stamp may move forward (restorePlans saves every plan) but may
+ * not go backwards or disappear, and a `simKey` it carried may change value
+ * (ProjectionLab re-runs the plan open in the tab) but may not disappear. A
+ * plan that carried no simKey, or a stamp that is not a number on either side,
+ * is not reported, so absent fields never read as a change. `label` names the
+ * plan in each problem, for example `original plan p1`.
+ */
+export function keptPlanIdentityProblems(label, before, after) {
+    const problems = [];
+    const simKey = before.simKey;
+    if (simKey !== undefined && simKey !== null) {
+        const current = after.simKey;
+        if (current === undefined || current === null) {
+            problems.push(`${label} lost its simKey`);
+        }
+    }
+    const was = before.lastUpdated;
+    const now = after.lastUpdated;
+    if (was !== undefined && was !== null) {
+        if (now === undefined || now === null) {
+            problems.push(`${label} lost its lastUpdated`);
+        }
+        else if (typeof was === "number" &&
+            typeof now === "number" &&
+            now < was) {
+            problems.push(`${label} lastUpdated moved backwards from ${was} to ${now}`);
+        }
+    }
+    return problems;
+}
 /** Field-by-field diff of two objects; values rendered as "from → to". */
 export function diffFields(current, incoming) {
     const cur = (current ?? {});