projectionlab-mcp 1.0.1 → 1.2.0

package/dist/tools/clonePlan.js

@@ -1,11 +1,12 @@
 import { z } from "zod";
 import { buildPlanClone, verifyPlanClone } from "../clonePlan.js";
 import { config } from "../config.js";
+import { currentFinancesProblems } from "../currentFinances.js";
 import { ProjectionLabError, errorResult } from "../errors.js";
 import { log } from "../logger.js";
 import { assertPlansUnchanged } from "../planVersion.js";
 import { toJson } from "../json.js";
-import { findPlanIndex, getEvents, planNotFoundError, requirePlans, } from "../plans.js";
+import { resolvePlanIndex, getEvents, planNotFoundError, requirePlans, } from "../plans.js";
 export function registerClonePlanTool(server, bridge, snapshots) {
     server.registerTool("projectionlab_clone_plan", {
         title: "Clone Plan",
@@ -13,7 +14,8 @@ export function registerClonePlanTool(server, bridge, snapshots) {
             "plan is left as it is; the copy is appended. Event ids are kept, as ProjectionLab's own " +
             "plan duplication does, so references between events, milestones and accounts stay intact. " +
             "When confirm is false (default), returns a dry-run preview. When confirm is true, " +
-            "auto-snapshots all plans, appends the copy, and verifies the other plans are unchanged. " +
+            "auto-snapshots all plans, appends the copy, and verifies the other plans are " +
+            "unchanged and that no Current Finances balance moved. " +
             "Edit the copy afterwards with projectionlab_update_plan_event or " +
             "projectionlab_update_plan_settings. projectionlab_rollback on the snapshot removes the copy.",
         inputSchema: {
@@ -21,7 +23,7 @@ export function registerClonePlanTool(server, bridge, snapshots) {
                 .string()
                 .trim()
                 .min(1)
-                .describe("Plan to copy: name (case-insensitive, partial match) or exact plan ID"),
+                .describe("Plan to copy: name (case-insensitive; a partial match must identify exactly one plan) or exact plan ID"),
             newName: z
                 .string()
                 .describe("Name for the new plan. Must not match an existing plan name (case-insensitive)."),
@@ -43,7 +45,7 @@ export function registerClonePlanTool(server, bridge, snapshots) {
             }
             const data = await bridge.exportData({ fresh: true });
             const plans = requirePlans(data);
-            const sourceIndex = findPlanIndex(plans, planIdentifier);
+            const sourceIndex = resolvePlanIndex(plans, planIdentifier);
             if (sourceIndex === -1)
                 throw planNotFoundError(plans, planIdentifier);
             const source = plans[sourceIndex];
@@ -85,8 +87,17 @@ export function registerClonePlanTool(server, bridge, snapshots) {
             await bridge.restorePlans([...plans, clone]);
             const verifyData = await bridge.exportData({ fresh: true });
             const after = Array.isArray(verifyData.plans) ? verifyData.plans : [];
-            const problems = verifyPlanClone(plans, after, clone);
+            const planProblems = verifyPlanClone(plans, after, clone);
+            const financeProblems = currentFinancesProblems(data.today, verifyData.today);
+            const problems = [...planProblems, ...financeProblems];
             const verified = problems.length === 0;
+            let message = "Plan copied and verified. Snapshot saved; projectionlab_rollback with this snapshotId removes the copy.";
+            if (!verified) {
+                message =
+                    planProblems.length > 0
+                        ? `Copy sent but verification found problems. Check the plans in ProjectionLab; projectionlab_rollback with snapshotId ${snapshot.id} restores the previous plans.`
+                        : "Copy landed, but Current Finances changed while the write was in flight. Cloning a plan does not write Current Finances, so this may be an edit made in ProjectionLab. The snapshot holds plans only, so rolling it back removes the copy and restores nothing else.";
+            }
             return {
                 content: [
                     {
@@ -97,9 +108,7 @@ export function registerClonePlanTool(server, bridge, snapshots) {
                             verified,
                             ...(verified ? {} : { verificationProblems: problems }),
                             snapshotId: snapshot.id,
-                            message: verified
-                                ? "Plan copied and verified. Snapshot saved; projectionlab_rollback with this snapshotId removes the copy."
-                                : `Copy sent but verification found problems. Check the plans in ProjectionLab; projectionlab_rollback with snapshotId ${snapshot.id} restores the previous plans.`,
+                            message,
                         }),
                     },
                 ],

package/dist/tools/clonePlan.js.map

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

package/dist/tools/connection.js

@@ -1,19 +1,35 @@
 import { z } from "zod";
+import { config } from "../config.js";
 import { errorResult } from "../errors.js";
 import { toJson } from "../json.js";
+import { updateCheck } from "../updateCheck.js";
+import { versionNotices } from "../versionNotices.js";
+import { VERSION } from "../version.js";
 export function registerConnectionTool(server, bridge) {
     server.registerTool("projectionlab_check_connection", {
         title: "Check Connection",
         description: "Verify connectivity to ProjectionLab. Checks that the browser is running, " +
             "the ProjectionLab page is loaded, the Plugin API is accessible, and the API key is valid. " +
+            "Also reports writesEnabled, which is false while the server is in read-only mode " +
+            "(PL_READ_ONLY is not \"false\") and every write tool, dry runs included, is refused. " +
             "Call this first in every session, before any other ProjectionLab tool. If any check " +
-            "fails, read the projectionlab://guide resource and walk the user through the fix.",
+            "fails, read the projectionlab://guide resource and walk the user through the fix. " +
+            "The result also carries versions (server, executor, latest npm release) and notices: " +
+            "plain sentences to relay to the user when a release is out of date.",
         outputSchema: {
             browser: z.boolean(),
             pageLoaded: z.boolean(),
             apiAvailable: z.boolean(),
             apiKeyValid: z.boolean(),
+            executor: z.string().optional(),
             errors: z.array(z.string()),
+            writesEnabled: z.boolean(),
+            versions: z.object({
+                server: z.string(),
+                executor: z.string().nullable(),
+                latest: z.string().nullable(),
+            }),
+            notices: z.array(z.string()),
         },
         annotations: {
             readOnlyHint: true,
@@ -22,10 +38,19 @@ export function registerConnectionTool(server, bridge) {
         },
     }, async () => {
         try {
-            const status = await bridge.checkConnection();
+            const status = {
+                ...(await bridge.checkConnection()),
+                writesEnabled: !config.readOnly,
+            };
+            const versions = {
+                server: VERSION,
+                executor: status.executor ?? null,
+                latest: updateCheck.latest(),
+            };
+            const result = { ...status, versions, notices: versionNotices(versions) };
             return {
-                content: [{ type: "text", text: toJson(status) }],
-                structuredContent: { ...status },
+                content: [{ type: "text", text: toJson(result) }],
+                structuredContent: result,
             };
         }
         catch (err) {

package/dist/tools/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/tools/connection.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;AAEpC,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAc;IAEd,MAAM,CAAC,YAAY,CACjB,gCAAgC,EAChC;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,4EAA4E;YAC5E,4FAA4F;YAC5F,sFAAsF;YACtF,mFAAmF;QACrF,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;YACpB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;YACvB,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;YACzB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;YACxB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC5B;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,iBAAiB,EAAE,EAAE,GAAG,MAAM,EAAE;aACjC,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mCAAmC,EACnC;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,mFAAmF;YACnF,kFAAkF;YAClF,uEAAuE;QACzE,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;aAC/C,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":"connection.js","sourceRoot":"","sources":["../../src/tools/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAc;IAEd,MAAM,CAAC,YAAY,CACjB,gCAAgC,EAChC;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,4EAA4E;YAC5E,4FAA4F;YAC5F,mFAAmF;YACnF,uFAAuF;YACvF,sFAAsF;YACtF,oFAAoF;YACpF,uFAAuF;YACvF,qEAAqE;QACvE,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;YACpB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;YACvB,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;YACzB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;YACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;YAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;gBAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC9B,CAAC;YACF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC7B;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;gBACnC,aAAa,EAAE,CAAC,MAAM,CAAC,QAAQ;aAChC,CAAC;YACF,MAAM,QAAQ,GAAG;gBACf,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;gBACjC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE;aAC7B,CAAC;YACF,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mCAAmC,EACnC;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,mFAAmF;YACnF,kFAAkF;YAClF,uEAAuE;QACzE,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;aAC/C,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/deletePlan.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Bridge } from "../bridge.js";
+import type { SnapshotManager } from "../snapshot.js";
+export declare function registerDeletePlanTool(server: McpServer, bridge: Bridge, snapshots: SnapshotManager): void;

package/dist/tools/deletePlan.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { config } from "../config.js";
+import { selectPlanForDeletion, verifyPlanDeletion, withoutPlan } from "../deletePlan.js";
+import { ProjectionLabError, errorResult } from "../errors.js";
+import { log } from "../logger.js";
+import { assertPlansUnchanged } from "../planVersion.js";
+import { toJson } from "../json.js";
+import { getEvents, requirePlans } from "../plans.js";
+export function registerDeletePlanTool(server, bridge, snapshots) {
+    server.registerTool("projectionlab_delete_plan", {
+        title: "Delete Plan",
+        description: "Permanently removes one plan by exact plan ID; names are never matched, so get the ID " +
+            "from projectionlab_describe_schema first. Refuses the last remaining plan. " +
+            "When confirm is false (default), returns a dry-run preview. When confirm is true, " +
+            "auto-snapshots all plans, writes the remaining plans, and verifies the deleted plan is " +
+            "gone while every other plan is unchanged. projectionlab_rollback on the snapshot " +
+            "restores the deleted plan.",
+        inputSchema: {
+            planId: z
+                .string()
+                .trim()
+                .min(1)
+                .describe("Exact plan ID only (from projectionlab_describe_schema). Names are not accepted for deletion."),
+            confirm: z
+                .boolean()
+                .default(false)
+                .describe("Set to true to execute. Default false returns a dry-run preview."),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ planId, confirm }) => {
+        try {
+            if (config.readOnly) {
+                throw new ProjectionLabError("READ_ONLY_MODE", "Write operations are disabled (read-only mode; PL_READ_ONLY is not \"false\")", "Ask the user whether to enable writes: set PL_READ_ONLY=false in the MCP host env block or ~/.projectionlab-mcp/.env, then restart the server");
+            }
+            const data = await bridge.exportData({ fresh: true });
+            const plans = requirePlans(data);
+            const target = selectPlanForDeletion(plans, planId);
+            const preview = {
+                plan: { name: target.name, id: target.id },
+                planCount: `${plans.length} → ${plans.length - 1}`,
+                eventCounts: {
+                    income: getEvents(target.income).length,
+                    expenses: getEvents(target.expenses).length,
+                    accounts: getEvents(target.accounts).length,
+                    assets: getEvents(target.assets).length,
+                    milestones: getEvents(target.milestones).length,
+                    priorities: getEvents(target.priorities).length,
+                },
+            };
+            if (!confirm) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: toJson({
+                                dryRun: true,
+                                operation: "deletePlan",
+                                ...preview,
+                                warning: `This will delete plan "${String(target.name)}" and all of its events. Set confirm=true to proceed. The plans are snapshotted first, so projectionlab_rollback can restore the plan.`,
+                            }),
+                        },
+                    ],
+                };
+            }
+            const snapshot = await snapshots.create("deletePlan", ["plans"], {
+                plans,
+            });
+            await assertPlansUnchanged(bridge, plans);
+            log.info("deletePlan", `Deleting plan "${String(target.name)}"`);
+            await bridge.restorePlans(withoutPlan(plans, String(target.id)));
+            const verifyData = await bridge.exportData({ fresh: true });
+            const after = Array.isArray(verifyData.plans) ? verifyData.plans : [];
+            const problems = verifyPlanDeletion(plans, after, String(target.id));
+            const verified = problems.length === 0;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: toJson({
+                            success: true,
+                            ...preview,
+                            verified,
+                            ...(verified ? {} : { verificationProblems: problems }),
+                            snapshotId: snapshot.id,
+                            message: verified
+                                ? "Plan deleted and verified. Snapshot saved; projectionlab_rollback with this snapshotId restores the plan."
+                                : `Delete sent but verification found problems. Check the plans in ProjectionLab; projectionlab_rollback with snapshotId ${snapshot.id} restores the previous plans.`,
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=deletePlan.js.map

package/dist/tools/deletePlan.js.map

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

package/dist/tools/diff.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Bridge } from "../bridge.js";
+import { type SnapshotManager } from "../snapshot.js";
+export declare function registerDiffTool(server: McpServer, bridge: Bridge, snapshots: SnapshotManager): void;