projectionlab-mcp 1.0.1 → 1.2.0

package/dist/tools/diff.js

@@ -0,0 +1,417 @@
+import { z } from "zod";
+import { resolveSnapshot, } from "../snapshot.js";
+import { ProjectionLabError, errorResult } from "../errors.js";
+import { toJson } from "../json.js";
+import { textOrFile } from "../largeOutput.js";
+import { redactSecrets } from "../redact.js";
+import { FIELD_CHANGE_CAP, createDiffBudget, diffPlanPair, diffSectionData, planKey, } from "../diff.js";
+import { PLAN_SECTIONS, resolvePlanIndex, planNotFoundError, } from "../plans.js";
+/** The data areas a snapshot can hold and this tool knows how to compare. */
+const COMPARED_SECTIONS = [
+    "plans",
+    "currentFinances",
+    "progress",
+    "settings",
+];
+/** A snapshot stores Current Finances under its own key; the export uses `today`. */
+function getSection(data, section) {
+    return section === "currentFinances" ? data.today : data[section];
+}
+function describeSnapshot(snapshot) {
+    return {
+        source: "snapshot",
+        snapshotId: snapshot.id,
+        timestamp: snapshot.timestamp,
+        operation: snapshot.operation,
+        sections: snapshot.sections,
+    };
+}
+function plansOf(...values) {
+    return values.flatMap((value) => (Array.isArray(value) ? value : []));
+}
+const selectorSchema = z
+    .object({
+    snapshotId: z
+        .string()
+        .optional()
+        .describe("Exact ID of a saved snapshot, from projectionlab_list_snapshots. Supply exactly one of snapshotId, nBack or beforeTime."),
+    nBack: z
+        .number()
+        .optional()
+        .describe("How many snapshots back, a positive integer with 1 as the most recent, counted in the same newest-first order as projectionlab_list_snapshots. Supply exactly one of snapshotId, nBack or beforeTime."),
+    beforeTime: z
+        .string()
+        .optional()
+        .describe("ISO 8601 time carrying an explicit Z or ±HH:MM offset, such as 2026-11-08T15:30:00Z; picks the latest snapshot taken strictly before it. Supply exactly one of snapshotId, nBack or beforeTime."),
+})
+    .strict();
+/**
+ * The tool compares one data set at two points in time (`time`) or two
+ * different plans side by side (`plans`). Which one is asked for decides which
+ * arguments are required, and the two modes share no argument, so a mixed call
+ * is refused with what to drop rather than guessed at.
+ */
+function requireMode(args) {
+    if (args.planA === undefined && args.planB === undefined) {
+        if (args.from === undefined) {
+            throw new ProjectionLabError("INVALID_INPUT", "No from snapshot selector supplied", "Supply from with exactly one of snapshotId, nBack or beforeTime to compare a snapshot against another snapshot or the live data, or supply planA and planB together to compare two plans");
+        }
+        return { mode: "time" };
+    }
+    if (args.planA === undefined || args.planB === undefined) {
+        const missing = args.planA === undefined ? "planA" : "planB";
+        throw new ProjectionLabError("INVALID_INPUT", `planA and planB compare two plans together, and ${missing} is missing`, "Name both plans, or drop planA and planB to compare a snapshot against another snapshot or the live data");
+    }
+    const { planA, planB } = args;
+    for (const name of ["to", "planIdentifier"]) {
+        if (args[name] !== undefined) {
+            throw new ProjectionLabError("INVALID_INPUT", `planA and planB compare two plans, and ${name} belongs to the points-in-time comparison`, `Drop ${name}. planA and planB read both plans from the live app, or from one snapshot with from. Compare points in time with from and to alone`);
+        }
+    }
+    return { mode: "plans", planA, planB };
+}
+/** A missing plan names the side it was asked for, so the fix is unambiguous. */
+function planSideNotFoundError(plans, identifier, side) {
+    const notFound = planNotFoundError(plans, identifier);
+    const position = side === "planA" ? "first" : "second";
+    return new ProjectionLabError("INVALID_INPUT", `${notFound.message} for ${side}`, `${side}'s values are reported ${position} in each "A → B" pair. ${notFound.suggestion}`);
+}
+/** How a plan is named to the user: its name, falling back to its id. */
+function planLabel(plan) {
+    const obj = (plan ?? {});
+    return String(obj.name ?? obj.id ?? "unnamed");
+}
+export function registerDiffTool(server, bridge, snapshots) {
+    /** The plans a plan-to-plan comparison reads, and where they came from. */
+    async function readPlansForPair(from) {
+        if (from) {
+            const snapshot = await resolveSnapshot(snapshots, from, "from snapshot");
+            const stored = snapshot.data.plans;
+            if (!Array.isArray(stored)) {
+                throw new ProjectionLabError("INVALID_INPUT", `The snapshot "${snapshot.id}" holds no plans data`, "Drop from to compare the plans in ProjectionLab now, or pick a snapshot whose sections include plans; projectionlab_list_snapshots shows what each snapshot holds");
+            }
+            return { plans: stored, readFrom: describeSnapshot(snapshot) };
+        }
+        const live = await bridge.exportData({ fresh: true });
+        const plans = Array.isArray(live.plans) ? live.plans : [];
+        if (plans.length === 0) {
+            throw new ProjectionLabError("INVALID_INPUT", "No plans found in ProjectionLab", "Create the plans in ProjectionLab first, or name two saved plans with from");
+        }
+        return {
+            plans,
+            readFrom: {
+                source: "live",
+                readAt: new Date().toISOString(),
+                note: "both plans read from ProjectionLab when this diff ran",
+            },
+        };
+    }
+    /** Compare two different plans field by field, planA's values reported first. */
+    async function comparePlans(args) {
+        const budget = createDiffBudget({
+            pathsOnly: args.pathsOnly === true,
+        });
+        const { plans, readFrom } = await readPlansForPair(args.from);
+        const indexA = resolvePlanIndex(plans, args.planA);
+        if (indexA === -1) {
+            throw planSideNotFoundError(plans, args.planA, "planA");
+        }
+        const indexB = resolvePlanIndex(plans, args.planB);
+        if (indexB === -1) {
+            throw planSideNotFoundError(plans, args.planB, "planB");
+        }
+        if (indexA === indexB) {
+            throw new ProjectionLabError("INVALID_INPUT", `planA and planB both name the same plan ("${planLabel(plans[indexA])}")`, "Name two different plans; projectionlab_describe_schema lists them by name and ID");
+        }
+        const pair = diffPlanPair(plans[indexA], plans[indexB], budget, args.section);
+        const result = {
+            mode: "plans",
+            planA: pair.a,
+            planB: pair.b,
+            readFrom,
+            ...(args.section ? { section: args.section } : {}),
+            ...(args.pathsOnly ? { pathsOnly: true } : {}),
+            changed: pair.changed,
+            ...(pair.changed
+                ? {}
+                : {
+                    message: "No differences in the fields compared. The plan's own id and name, each event's own id and random key, and the computed fields (lastUpdated, simKey, meta) are excluded, and a reference to another event of the same plan is compared by the event it names, so a plan rebuilt by hand reads as unchanged.",
+                }),
+            planSettings: pair.settings,
+            ...(pair.sections ? { sections: pair.sections } : {}),
+            ...(pair.changedSections
+                ? { changedSections: pair.changedSections }
+                : {}),
+            fieldChangeCap: budget.fieldChangeCap,
+            ...(budget.omittedFieldChanges > 0
+                ? { omittedFieldChanges: budget.omittedFieldChanges }
+                : {}),
+            ...(budget.omittedEntries > 0
+                ? { omittedEntries: budget.omittedEntries }
+                : {}),
+        };
+        const json = toJson(redactSecrets(result, { byName: true }));
+        // A spilled result keeps the facts that name the comparison; the
+        // sections themselves stay in the file it points at.
+        const { sections: _sections, ...summary } = result;
+        return {
+            content: [
+                { type: "text", text: await textOrFile(json, "diff", summary) },
+            ],
+        };
+    }
+    server.registerTool("projectionlab_diff", {
+        title: "Diff Snapshots Over Time, or Two Plans Against Each Other",
+        description: "Reports field-level differences, read-only: it never writes and never " +
+            "snapshots, so it works with PL_READ_ONLY=true. Two modes, told apart by the " +
+            "arguments you supply. " +
+            "Points in time: from is required and names a saved snapshot with exactly " +
+            "one of snapshotId, nBack or beforeTime, resolved the way " +
+            "projectionlab_rollback resolves them. " +
+            "to is optional: another snapshot selector, or omitted to compare against the data in " +
+            "ProjectionLab right now. " +
+            "Only the data sections the from snapshot holds are compared, and when to is a snapshot, " +
+            "only the sections both hold; comparedSections says which. " +
+            "For plans it reports plans added, removed and changed, and within a changed plan the " +
+            "events added, removed and modified per section, each modification as " +
+            "\"path\": \"before → after\" dot paths you can read back with projectionlab_get_plan_section " +
+            "or patch with projectionlab_update_plan_event. " +
+            "Computed plan fields (lastUpdated, simKey, meta) are left out, so a plan ProjectionLab " +
+            "merely re-saved reads as unchanged. " +
+            "For Current Finances it reports rows added, removed and modified by id within each " +
+            "collection. " +
+            "Use it to confirm a write landed as intended, to explain to the user what changed, or to " +
+            "see what projectionlab_rollback would undo before rolling back. " +
+            "Narrow the output with planIdentifier (plan name or ID) and section. " +
+            "Two plans: planA and planB name two different plans and compare one against the " +
+            "other, so a plan rebuilt by hand in the ProjectionLab UI can be checked against " +
+            "the original. Both plans are read from the live app, or from one snapshot when " +
+            "from is also given; planA and planB cannot be combined with to or planIdentifier. " +
+            "Events match by name plus occurrence. The fields that say which plan an object is " +
+            "(the plan's id and name, each event's own id) and the computed fields are left " +
+            "out, as is each event's random key, which ProjectionLab assigns when the event is " +
+            "created, so re-entering the same event does not read as a difference. A reference " +
+            "from one event to another event of the same plan, such as a " +
+            "milestone id in a start or end condition, is compared by the event it names, so " +
+            "the same milestone still compares equal under the unrelated ids two plans store. " +
+            "Each section reports onlyInA, onlyInB, different (each with \"path\": \"planA " +
+            "value → planB value\") and sameCount; planSettings reports the plan's own fields " +
+            "outside the sections. Use it to answer \"does the plan I rebuilt match the " +
+            "original?\" " +
+            "In either mode pathsOnly: true reports the paths that differ with no values, for " +
+            "a comparison whose values are private. " +
+            "Any value whose path names a credential (apiKey, token, password, ...) is reported as " +
+            "[REDACTED] rather than shown, and a value longer than 200 characters is truncated with its " +
+            "original length. Output is capped at " +
+            `${FIELD_CHANGE_CAP} field changes, with omittedFieldChanges and per-entry ` +
+            "omittedChanges counting the rest; a difference past the cap is still counted as changed.",
+        inputSchema: {
+            from: selectorSchema
+                .optional()
+                .describe("The baseline side, whose values are reported as before: one saved snapshot, selected like projectionlab_rollback does. Required to compare points in time. With planA and planB it is optional and names the one snapshot both plans are read from."),
+            to: selectorSchema
+                .optional()
+                .describe("The side whose values are reported as after: another saved snapshot, or omit it to compare against the live data read from ProjectionLab now. Points-in-time mode only; never combine it with planA or planB."),
+            planIdentifier: z
+                .string()
+                .trim()
+                .min(1)
+                .optional()
+                .describe("Report one plan only: plan name (case-insensitive; a partial match must identify exactly one plan) or exact plan ID. Points-in-time mode only; name the plans with planA and planB instead."),
+            planA: z
+                .string()
+                .trim()
+                .min(1)
+                .optional()
+                .describe("Compare two different plans instead of two points in time: the plan whose values are reported first, by plan name (case-insensitive; a partial match must identify exactly one plan) or exact plan ID. Supply planA and planB together, never with to or planIdentifier."),
+            planB: z
+                .string()
+                .trim()
+                .min(1)
+                .optional()
+                .describe("The second plan of a plan-to-plan comparison, whose values are reported second in each \"A → B\" pair. Supply it together with planA."),
+            section: z
+                .enum(PLAN_SECTIONS)
+                .optional()
+                .describe("Compare one plan section only, such as income or expenses. Plan settings outside the sections are still compared."),
+            pathsOnly: z
+                .boolean()
+                .optional()
+                .describe("Report the paths that differ with no values, for a comparison whose values are private. Works in both modes."),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        try {
+            const request = requireMode(args);
+            if (request.mode === "plans") {
+                return await comparePlans({
+                    planA: request.planA,
+                    planB: request.planB,
+                    from: args.from,
+                    section: args.section,
+                    pathsOnly: args.pathsOnly,
+                });
+            }
+            // The points-in-time mode: one data set read at two moments.
+            const { from = {}, to, planIdentifier, section } = args;
+            const fromSnapshot = await resolveSnapshot(snapshots, from, "from snapshot");
+            const toSnapshot = to
+                ? await resolveSnapshot(snapshots, to, "to snapshot")
+                : null;
+            // Against the live data every section the from snapshot holds is
+            // available; against another snapshot, only the sections both hold.
+            const comparedSections = fromSnapshot.sections.filter((name) => COMPARED_SECTIONS.includes(name) &&
+                (toSnapshot === null || toSnapshot.sections.includes(name)));
+            const notCompared = [];
+            const mentioned = new Set([
+                ...fromSnapshot.sections,
+                ...(toSnapshot ? toSnapshot.sections : []),
+            ]);
+            for (const name of [...mentioned].sort()) {
+                if (comparedSections.includes(name))
+                    continue;
+                if (!COMPARED_SECTIONS.includes(name)) {
+                    notCompared.push({
+                        section: name,
+                        reason: "this tool does not compare that section",
+                    });
+                }
+                else if (!fromSnapshot.sections.includes(name)) {
+                    notCompared.push({
+                        section: name,
+                        reason: "the from snapshot does not hold it",
+                    });
+                }
+                else {
+                    notCompared.push({
+                        section: name,
+                        reason: "the to snapshot does not hold it",
+                    });
+                }
+            }
+            if (comparedSections.length === 0) {
+                throw new ProjectionLabError("INVALID_INPUT", toSnapshot
+                    ? `The two snapshots share no comparable data section; from holds [${fromSnapshot.sections.join(", ")}] and to holds [${toSnapshot.sections.join(", ")}]`
+                    : `The from snapshot holds no comparable data section: [${fromSnapshot.sections.join(", ")}]`, "Compare a snapshot whose sections overlap, or diff against the live data by omitting to. Snapshots record the sections they saved; projectionlab_list_snapshots shows them");
+            }
+            // `to` is either a snapshot or the live export; one reader covers both.
+            const live = toSnapshot ? null : await bridge.exportData({ fresh: true });
+            const newerValue = (name) => toSnapshot ? toSnapshot.data[name] : getSection(live ?? {}, name);
+            // A section one side carries no data for is not a difference, it is
+            // nothing to compare: rollback skips such a section rather than
+            // restoring nothing, so diffing it would report every field as
+            // "(absent)" and describe a change no rollback would make.
+            const compared = [];
+            for (const name of comparedSections) {
+                const before = fromSnapshot.data[name];
+                const after = newerValue(name);
+                if (before === undefined) {
+                    notCompared.push({
+                        section: name,
+                        reason: "the from snapshot holds no data for it",
+                    });
+                    continue;
+                }
+                if (after === undefined) {
+                    notCompared.push({
+                        section: name,
+                        reason: toSnapshot
+                            ? "the to snapshot holds no data for it"
+                            : "the live export returned no such section",
+                    });
+                    continue;
+                }
+                compared.push({ section: name, before, after });
+            }
+            if (compared.length === 0) {
+                throw new ProjectionLabError("INVALID_INPUT", `Both sides list [${comparedSections.join(", ")}] but no section carries data on both sides`, "Confirm what the snapshot saved with projectionlab_list_snapshots and read the current data with projectionlab_export_data");
+            }
+            const wantsPlans = compared.some((entry) => entry.section === "plans");
+            if (section && !wantsPlans) {
+                throw new ProjectionLabError("INVALID_INPUT", `section "${section}" narrows the plans comparison, but no plans data is being compared`, `Drop section, or pick a snapshot whose sections include plans; projectionlab_list_snapshots shows what each snapshot holds`);
+            }
+            const newerPlans = wantsPlans ? plansOf(newerValue("plans")) : [];
+            let planOnlyKey;
+            if (planIdentifier) {
+                if (!wantsPlans) {
+                    throw new ProjectionLabError("INVALID_INPUT", `planIdentifier "${planIdentifier}" narrows the plans comparison, but no plans data is being compared`, "Drop planIdentifier, or pick a snapshot whose sections include plans; projectionlab_list_snapshots shows what each snapshot holds");
+                }
+                const olderPlans = plansOf(fromSnapshot.data.plans);
+                const beforeIndex = resolvePlanIndex(olderPlans, planIdentifier);
+                const afterIndex = resolvePlanIndex(newerPlans, planIdentifier);
+                const match = beforeIndex !== -1
+                    ? olderPlans[beforeIndex]
+                    : afterIndex !== -1
+                        ? newerPlans[afterIndex]
+                        : undefined;
+                if (match === undefined) {
+                    const byKey = new Map(plansOf(fromSnapshot.data.plans, newerPlans).map((plan) => [
+                        planKey(plan),
+                        plan,
+                    ]));
+                    throw planNotFoundError([...byKey.values()], planIdentifier);
+                }
+                planOnlyKey = planKey(match);
+            }
+            const budget = createDiffBudget({
+                pathsOnly: args.pathsOnly === true,
+            });
+            const sections = {};
+            let changed = false;
+            for (const entry of compared) {
+                const payload = diffSectionData(entry.section, entry.before, entry.after, budget, {
+                    planSection: entry.section === "plans" ? section : undefined,
+                    planOnlyKey: entry.section === "plans" ? planOnlyKey : undefined,
+                });
+                sections[entry.section] = payload;
+                if (payload.changed)
+                    changed = true;
+            }
+            const result = {
+                from: describeSnapshot(fromSnapshot),
+                to: toSnapshot
+                    ? describeSnapshot(toSnapshot)
+                    : {
+                        source: "live",
+                        readAt: new Date().toISOString(),
+                        note: "read from ProjectionLab when this diff ran",
+                    },
+                comparedSections: compared.map((entry) => entry.section),
+                ...(notCompared.length > 0 ? { notCompared } : {}),
+                ...(planIdentifier ? { planIdentifier } : {}),
+                ...(section ? { section } : {}),
+                changed,
+                ...(changed
+                    ? {}
+                    : {
+                        message: "No differences in the compared sections. Computed plan fields (lastUpdated, simKey, meta) are excluded, so a plan ProjectionLab only re-saved reads as unchanged.",
+                    }),
+                sections,
+                fieldChangeCap: budget.fieldChangeCap,
+                ...(budget.omittedFieldChanges > 0
+                    ? { omittedFieldChanges: budget.omittedFieldChanges }
+                    : {}),
+                ...(budget.omittedEntries > 0
+                    ? { omittedEntries: budget.omittedEntries }
+                    : {}),
+            };
+            const json = toJson(redactSecrets(result, { byName: true }));
+            // A spilled result keeps the facts that name the comparison; the
+            // sections themselves stay in the file it points at.
+            const { sections: _sections, ...summary } = result;
+            return {
+                content: [
+                    { type: "text", text: await textOrFile(json, "diff", summary) },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=diff.js.map

package/dist/tools/diff.js.map

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

package/dist/tools/getCurrentFinances.js

@@ -1,16 +1,30 @@
 import { z } from "zod";
+import { annotateAddressableValues } from "../dataModel.js";
 import { currentFinanceAccountNotFoundError, findCurrentFinanceEntry, requireCurrentFinances, } from "../currentFinances.js";
 import { ProjectionLabError, errorResult } from "../errors.js";
 import { toJson } from "../json.js";
 import { textOrFile } from "../largeOutput.js";
 import { listAddressableValues } from "../pathPatch.js";
 import { redactSecrets } from "../redact.js";
+import { buildRealEstateBlock, withRealEstateBlocks } from "../realEstate.js";
 export function registerGetCurrentFinancesTool(server, bridge) {
     server.registerTool("projectionlab_get_current_finances", {
         title: "Get Current Finances",
         description: "Returns just the Current Finances section (account balances, debts, real estate) " +
             "without plan data. Narrow to one existing account by exact ID, and set listPaths=true " +
-            "to discover typed dot paths for projectionlab_update_account pathChanges.",
+            "to discover typed dot paths for projectionlab_update_account pathChanges. " +
+            "Real-estate assets (assets entries with type \"real-estate\") carry a realEstate block " +
+            "that labels the fields ProjectionLab stores confusingly: marketValue is the stored " +
+            "amount, loanBalance is the remaining loan balance (never the property's value; an " +
+            "absent balance reads as 0), and netEquity is marketValue minus loanBalance, an " +
+            "arithmetic on stored fields and not ProjectionLab's own net-worth figure, which can " +
+            "depend on excludeLoanFromLNW. The block also carries paymentMethod, classification and " +
+            "excludeLoanFromLNW where present, loan terms (apr, interestType, monthlyPayment, " +
+            "compounding) when paymentMethod is \"financed\", and carrying costs (propertyTax, " +
+            "insurance, maintenance, monthlyHOA, appreciation) where present. Values come from the " +
+            "Current Finances record only, never from plan-modeled asset events. Only the amount " +
+            "and balance labels are verified; the other labels name stored fields whose UI meaning " +
+            "is not yet confirmed. Raw fields are kept unchanged alongside the block.",
         inputSchema: {
             accountId: z
                 .string()
@@ -33,24 +47,33 @@ export function registerGetCurrentFinancesTool(server, bridge) {
             if (listPaths && accountId === undefined) {
                 throw new ProjectionLabError("INVALID_INPUT", "listPaths requires accountId", "Supply the exact account ID returned by projectionlab_get_current_finances");
             }
-            let output = today;
+            let output;
             let suffix = "all";
             if (accountId !== undefined) {
                 const entry = findCurrentFinanceEntry(today, accountId);
                 if (!entry) {
                     throw currentFinanceAccountNotFoundError(today, accountId);
                 }
+                const realEstate = !listPaths && entry.collection === "assets"
+                    ? buildRealEstateBlock(entry.account)
+                    : null;
                 output = {
                     accountId,
                     accountName: entry.account.name,
                     collection: entry.collection,
                     ...(listPaths ? { listPaths: true } : {}),
                     data: listPaths
-                        ? listAddressableValues(entry.account)
-                        : entry.account,
+                        ? annotateAddressableValues(entry.collection, listAddressableValues(entry.account))
+                        : {
+                            ...entry.account,
+                            ...(realEstate ? { realEstate } : {}),
+                        },
                 };
                 suffix = accountId;
             }
+            else {
+                output = withRealEstateBlocks(today);
+            }
             return {
                 content: [
                     {

package/dist/tools/getCurrentFinances.js.map

@@ -1 +1 @@
-{"version":3,"file":"getCurrentFinances.js","sourceRoot":"","sources":["../../src/tools/getCurrentFinances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,8BAA8B,CAC5C,MAAiB,EACjB,MAAc;IAEd,MAAM,CAAC,YAAY,CACjB,oCAAoC,EACpC;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,mFAAmF;YACnF,wFAAwF;YACxF,2EAA2E;QAC7E,WAAW,EAAE;YACX,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;YAClE,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CACP,8FAA8F,CAC/F;SACJ;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEjD,IAAI,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,IAAI,kBAAkB,CAC1B,eAAe,EACf,8BAA8B,EAC9B,4EAA4E,CAC7E,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,GAAY,KAAK,CAAC;YAC5B,IAAI,MAAM,GAAG,KAAK,CAAC;YACnB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBACxD,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,kCAAkC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAC7D,CAAC;gBACD,MAAM,GAAG;oBACP,SAAS;oBACT,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;oBAC/B,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,IAAI,EAAE,SAAS;wBACb,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC;wBACtC,CAAC,CAAC,KAAK,CAAC,OAAO;iBAClB,CAAC;gBACF,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM,UAAU,CACpB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/C,kBAAkB,EAClB,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getCurrentFinances.js","sourceRoot":"","sources":["../../src/tools/getCurrentFinances.ts"],"names":[],"mappings":"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"}

package/dist/tools/getPlan.js

@@ -3,20 +3,20 @@ import { errorResult } from "../errors.js";
 import { toJson } from "../json.js";
 import { textOrFile } from "../largeOutput.js";
 import { redactSecrets } from "../redact.js";
-import { findPlan, getEvents, planNotFoundError, requirePlans, } from "../plans.js";
+import { resolvePlan, getEvents, planNotFoundError, requirePlans, } from "../plans.js";
 export function registerGetPlanTool(server, bridge) {
     server.registerTool("projectionlab_get_plan", {
         title: "Get Plan",
         description: "Returns a single plan by name or ID. Much smaller than export_data. " +
             "Use this for deep analysis of a specific plan; prefer " +
             "projectionlab_get_plan_section when only one aspect is needed. " +
-            "Accepts a plan name (case-insensitive partial match) or exact plan ID.",
+            "Accepts a plan name (case-insensitive; a partial match must identify exactly one plan) or exact plan ID.",
         inputSchema: {
             planIdentifier: z
                 .string()
                 .trim()
                 .min(1)
-                .describe("Plan name (case-insensitive, partial match) or exact plan ID"),
+                .describe("Plan name (case-insensitive; a partial match must identify exactly one plan) or exact plan ID"),
         },
         annotations: {
             readOnlyHint: true,
@@ -27,7 +27,7 @@ export function registerGetPlanTool(server, bridge) {
         try {
             const data = await bridge.exportData();
             const plans = requirePlans(data);
-            const plan = findPlan(plans, planIdentifier);
+            const plan = resolvePlan(plans, planIdentifier);
             if (!plan)
                 throw planNotFoundError(plans, planIdentifier);
             const header = {

package/dist/tools/getPlan.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPlan.js","sourceRoot":"","sources":["../../src/tools/getPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAc;IACnE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,sEAAsE;YACtE,wDAAwD;YACxD,iEAAiE;YACjE,wEAAwE;QAC1E,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,8DAA8D,CAC/D;SACJ;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI;gBAAE,MAAM,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,cAAc,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM;gBACjD,gBAAgB,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;gBAC/C,iBAAiB,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;gBAClD,iBAAiB,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;gBAClD,eAAe,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;gBAC9C,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;aACnC,CAAC;YAEF,MAAM,MAAM,GAAG,iBAAiB,MAAM,CAAC,MAAM,CAAC,wBAAwB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAEtH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;qBAChE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getPlan.js","sourceRoot":"","sources":["../../src/tools/getPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAc;IACnE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,sEAAsE;YACtE,wDAAwD;YACxD,iEAAiE;YACjE,0GAA0G;QAC5G,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,+FAA+F,CAChG;SACJ;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAChD,IAAI,CAAC,IAAI;gBAAE,MAAM,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,cAAc,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM;gBACjD,gBAAgB,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;gBAC/C,iBAAiB,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;gBAClD,iBAAiB,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM;gBAClD,eAAe,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM;gBAC9C,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;aACnC,CAAC;YAEF,MAAM,MAAM,GAAG,iBAAiB,MAAM,CAAC,MAAM,CAAC,wBAAwB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAEtH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;qBAChE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/getPlanSection.js

@@ -1,10 +1,11 @@
 import { z } from "zod";
+import { annotateAddressableValues } from "../dataModel.js";
 import { ProjectionLabError, errorResult } from "../errors.js";
 import { toJson } from "../json.js";
 import { textOrFile } from "../largeOutput.js";
 import { listAddressableValues } from "../pathPatch.js";
 import { redactSecrets } from "../redact.js";
-import { PLAN_SECTIONS, eventLabel, findEventIndex, findPlan, getEvents, planNotFoundError, requirePlans, } from "../plans.js";
+import { PLAN_SECTIONS, eventLabel, resolveEventIndex, resolvePlan, getEvents, planNotFoundError, requirePlans, } from "../plans.js";
 /** Resolve a dot-path like "events[3].rothConversions" or "events.3.name". */
 function resolvePath(root, path) {
     const parts = path
@@ -40,7 +41,7 @@ export function registerGetPlanSectionTool(server, bridge) {
                 .string()
                 .trim()
                 .min(1)
-                .describe("Plan name (case-insensitive, partial match) or exact plan ID"),
+                .describe("Plan name (case-insensitive; a partial match must identify exactly one plan) or exact plan ID"),
             section: z
                 .enum(PLAN_SECTIONS)
                 .describe("Which section of the plan to return"),
@@ -49,7 +50,7 @@ export function registerGetPlanSectionTool(server, bridge) {
                 .trim()
                 .min(1)
                 .optional()
-                .describe("Return only the event whose name (case-insensitive, partial match) or ID matches. " +
+                .describe("Return only the event whose name (case-insensitive; a partial match must identify exactly one event) or ID matches. " +
                 "Only valid for event-based sections (income, expenses, accounts, assets, milestones, priorities)."),
             path: z
                 .string()
@@ -70,7 +71,7 @@ export function registerGetPlanSectionTool(server, bridge) {
         try {
             const data = await bridge.exportData();
             const plans = requirePlans(data);
-            const plan = findPlan(plans, planIdentifier);
+            const plan = resolvePlan(plans, planIdentifier);
             if (!plan)
                 throw planNotFoundError(plans, planIdentifier);
             let sectionData = plan[section];
@@ -79,7 +80,7 @@ export function registerGetPlanSectionTool(server, bridge) {
             }
             if (eventIdentifier !== undefined) {
                 const events = getEvents(sectionData);
-                const index = findEventIndex(events, eventIdentifier);
+                const index = resolveEventIndex(events, eventIdentifier);
                 const match = index === -1 ? undefined : events[index];
                 if (!match) {
                     throw new ProjectionLabError("INVALID_INPUT", `No event matching "${eventIdentifier}" in section "${section}" of plan "${plan.name}"`, `Available events: ${events.map(eventLabel).sort().join(", ") || "(none)"}`);
@@ -94,7 +95,7 @@ export function registerGetPlanSectionTool(server, bridge) {
                 sectionData = resolved;
             }
             if (listPaths) {
-                sectionData = listAddressableValues(sectionData);
+                sectionData = annotateAddressableValues(section, listAddressableValues(sectionData));
             }
             const output = {
                 planName: plan.name,