@askthew/mcp-plugin 0.4.8 → 0.4.10

package/dist/index.js

@@ -2,6 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { spawn } from "node:child_process";
 import fs from "node:fs";
+import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { z } from "zod";
@@ -10,9 +11,18 @@ import { resolveMcpMode } from "./lib/free-tier-policy.js";
 import { LocalStore } from "./lib/local-store.js";
 import { buildTelemetryPayload, flushTelemetryOutbox } from "./lib/telemetry.js";
 import { ensureLocalIdentity } from "./lib/local-identity.js";
-import { buildLocalTimeline, buildTimelineInsights as buildLocalTimelineInsights, renderTimelineMarkdown as renderLocalTimelineMarkdown } from "./lib/timeline-insights.js";
-import { paidDescription, paidFeatureNudge, toolJson } from "./lib/upgrade-nudge.js";
+import { paidFeatureNudge, toolJson } from "./lib/upgrade-nudge.js";
 import { configPath, readJsonFile } from "./lib/paths.js";
+const requirePackageJson = createRequire(import.meta.url);
+function packageVersion() {
+    try {
+        const manifest = requirePackageJson("../package.json");
+        return typeof manifest.version === "string" ? manifest.version : "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
 const evidenceRoleSchema = z.enum(["user", "assistant", "system"]);
 const evidenceEntrySchema = z.object({
     role: evidenceRoleSchema,
@@ -311,6 +321,8 @@ const echoSchema = z.enum(["summary", "full"]).optional();
 const cursorSchema = z.string().optional();
 const idempotencyKeySchema = z.string().min(1).max(200).optional();
 const maxCharsSchema = z.number().int().positive().max(100000).optional();
+const LIMITED_LOCAL_TOOL_LIMIT = 3;
+const LIMIT_REACHED_MESSAGE = "Limit reached. Upgrade to the paid plan.";
 function traceId() {
     return `trace_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
 }
@@ -570,7 +582,7 @@ export function createAskTheWMcpServer(options = {}) {
     }
     const server = new McpServer({
         name: "Ask The W Coding Agent Connector",
-        version: "0.4.7",
+        version: packageVersion(),
     });
     if (options.sendStartupHeartbeat !== false && mode.mode === "paid") {
         void sendStartupSignals(options);
@@ -612,6 +624,7 @@ export function createAskTheWMcpServer(options = {}) {
     const compactWriteResponse = (input) => localResponse({
         ok: input.ok !== false,
         id: input.id ?? null,
+        ...(input.decisionId ? { decisionId: input.decisionId } : {}),
         ...(input.sessionId ? { sessionId: input.sessionId } : {}),
         ...(typeof input.sequence === "number" ? { sequence: input.sequence } : {}),
         ...(typeof input.signalCount === "number" ? { signalCount: input.signalCount } : {}),
@@ -656,6 +669,28 @@ export function createAskTheWMcpServer(options = {}) {
         }
         return null;
     };
+    const limitReachedResponse = (tool) => localResponse({
+        ok: false,
+        code: "free_tier_limit_reached",
+        tool,
+        message: LIMIT_REACHED_MESSAGE,
+        limit: LIMITED_LOCAL_TOOL_LIMIT,
+        pricingUrl: "https://askthew.com/pricing",
+        upgradeUrl: `https://askthew.com/plugin?utm_source=mcp-plugin&utm_medium=tool-limit&utm_campaign=mcp-free&tool=${tool}`,
+        supportEmail: "support@askthew.com",
+    });
+    const consumeLimitedLocalUse = (tool) => {
+        if (!localStore)
+            return null;
+        const key = `usage:${tool}`;
+        const current = Number(localStore.getMeta(key) || "0");
+        const count = Number.isFinite(current) ? Math.max(0, Math.floor(current)) : 0;
+        if (count >= LIMITED_LOCAL_TOOL_LIMIT) {
+            return limitReachedResponse(tool);
+        }
+        localStore.setMeta(key, String(count + 1));
+        return null;
+    };
     server.tool("capture_session_signal", {
         sessionId: z.string().min(1),
         sequence: z.number().int().nonnegative(),
@@ -699,6 +734,19 @@ export function createAskTheWMcpServer(options = {}) {
                 scopeKey,
                 limit: 100000,
             }).length;
+            const existingDecision = localStore.getDecisionForSignal(signal.id);
+            const decisionCandidate = candidateFromSignal(signal, existingDecision);
+            const autoDecision = decisionCandidate
+                ? localStore.createDecision({
+                    rawContent: signal.summary,
+                    headline: signal.summary,
+                    status: decisionCandidate.suggestedStatus,
+                    sessionId: signal.sessionId,
+                    files: signal.filesTouched,
+                    sourceSignalIds: [signal.id],
+                    scopeKey,
+                })
+                : null;
             if (sessionSignal.kind === "final_summary" && mode.cliCredentials) {
                 localStore.enqueueTelemetry(buildTelemetryPayload({
                     store: localStore,
@@ -715,6 +763,7 @@ export function createAskTheWMcpServer(options = {}) {
             if (!payload.echo) {
                 return compactWriteResponse({
                     id: signal.id,
+                    decisionId: autoDecision?.id,
                     sessionId: signal.sessionId,
                     sequence: signal.sequence,
                     signalCount: sessionSignalCount,
@@ -729,12 +778,14 @@ export function createAskTheWMcpServer(options = {}) {
                     signalCount: sessionSignalCount,
                     summary: signal.summary,
                     kind: signal.kind,
+                    ...(autoDecision ? { decisionId: autoDecision.id } : {}),
                 });
             }
             return localResponse({
                 ok: true,
                 tier: "free",
                 signal,
+                ...(autoDecision ? { decision: decisionWithSignals(localStore, autoDecision) } : {}),
                 note: localStore.usingJsonFallback
                     ? "Captured locally in JSON fallback mode because SQLite was unavailable."
                     : "Captured locally in SQLite. Aggregate telemetry only may flush on final_summary unless opted out.",
@@ -910,190 +961,6 @@ export function createAskTheWMcpServer(options = {}) {
             ? { ok: true, id: upstreamId(upstream), sequence: upstreamSequence(upstream) ?? 1 }
             : upstream);
     });
-    server.tool("update_decision", {
-        id: z.string().min(1),
-        headline: z.string().min(1).optional(),
-        why: z.string().optional(),
-        status: z.enum(["proposed", "committed", "shipped", "abandoned"]).optional(),
-        alignment: z.enum(["aligned", "orthogonal", "conflicts", "ambiguous"]).optional(),
-        outcomeId: z.string().min(1).optional(),
-        idempotencyKey: idempotencyKeySchema,
-        echo: echoSchema,
-    }, async (payload) => {
-        if (mode.mode !== "paid" && localStore) {
-            const loginRequired = requireFreeIdentity();
-            if (loginRequired)
-                return loginRequired;
-            const decision = localStore.updateDecision(payload.id, {
-                ...(payload.headline ? { headline: payload.headline } : {}),
-                ...(payload.why !== undefined ? { why: payload.why } : {}),
-                ...(payload.status ? { status: payload.status } : {}),
-                ...(payload.alignment !== undefined ? { alignment: payload.alignment } : {}),
-            });
-            if (!decision) {
-                return localToolError({
-                    code: "not_found",
-                    message: "Decision not found in the local Ask The W store.",
-                    retryable: false,
-                    hint: "Check the decision id before updating.",
-                });
-            }
-            const warnings = detectDecisionConflicts({
-                decision,
-                decisions: localStore.listDecisions({ limit: 100000, scopeKey: currentScopeKey() }),
-            });
-            if (!payload.echo) {
-                return compactWriteResponse({ id: decision.id, sequence: localStore.stats().decisions, warnings });
-            }
-            return localResponse(payload.echo === "summary"
-                ? { ok: true, id: decision.id, sequence: localStore.stats().decisions, headline: decision.headline, warnings }
-                : { ok: true, tier: "free", decision: decisionWithSignals(localStore, decision), warnings });
-        }
-        const upstream = await postToServer(payload.echo === "full"
-            ? `/api/decisions/${encodeURIComponent(payload.id)}`
-            : withResponseShape(`/api/decisions/${encodeURIComponent(payload.id)}`), {
-            headline: payload.headline,
-            why: payload.why,
-            status: payload.status,
-            alignment: payload.alignment,
-            outcomeId: payload.outcomeId,
-        }, options, { method: "PATCH", idempotencyKey: payload.idempotencyKey });
-        const failure = upstreamFailure(upstream);
-        if (failure)
-            return localResponse(failure);
-        if (!payload.echo) {
-            return compactWriteResponse({ id: upstreamId(upstream) ?? payload.id, sequence: upstreamSequence(upstream) ?? 1 });
-        }
-        return localResponse(payload.echo === "summary"
-            ? { ok: true, id: upstreamId(upstream) ?? payload.id, sequence: upstreamSequence(upstream) ?? 1 }
-            : upstream);
-    });
-    server.tool("delete_decision", {
-        id: z.string().min(1),
-        confirmText: z.string().min(1),
-        idempotencyKey: idempotencyKeySchema,
-    }, async (payload) => {
-        if (mode.mode !== "paid" && localStore) {
-            const loginRequired = requireFreeIdentity();
-            if (loginRequired)
-                return loginRequired;
-            if (payload.confirmText !== payload.id) {
-                return localToolError({
-                    code: "confirmation_required",
-                    message: "confirmText must match the decision id.",
-                    retryable: false,
-                    hint: "Pass the exact decision id as confirmText.",
-                });
-            }
-            return localResponse({ ok: localStore.deleteDecision(payload.id), tier: "free" });
-        }
-        return apiToolResponse(`/api/decisions/${encodeURIComponent(payload.id)}`, {
-            confirmText: payload.confirmText,
-        }, "DELETE", { idempotencyKey: payload.idempotencyKey });
-    });
-    server.tool("list_outcomes", paidDescription("List outcomes from your workspace.", mode.mode), {
-        limit: z.number().int().positive().max(300).optional(),
-        cursor: cursorSchema,
-    }, async (payload) => {
-        if (mode.mode === "free")
-            return localResponse(paidFeatureNudge("list_outcomes"));
-        return apiToolResponse(routeWithQuery("/api/outcomes", {
-            limit: payload.limit,
-            cursor: payload.cursor,
-        }));
-    });
-    server.tool("get_outcome", paidDescription("Get outcome detail from your workspace.", mode.mode), {
-        id: z.string().min(1),
-    }, async (payload) => mode.mode === "free"
-        ? localResponse(paidFeatureNudge("get_outcome"))
-        : apiToolResponse(`/api/outcomes/${encodeURIComponent(payload.id)}`));
-    server.tool("list_outcome_signals", paidDescription("List signals linked to an outcome.", mode.mode), {
-        id: z.string().min(1),
-        limit: z.number().int().positive().max(300).optional(),
-        cursor: cursorSchema,
-    }, async (payload) => mode.mode === "free"
-        ? localResponse(paidFeatureNudge("list_outcome_signals"))
-        : apiToolResponse(routeWithQuery(`/api/outcomes/${encodeURIComponent(payload.id)}/signals`, {
-            limit: payload.limit,
-            cursor: payload.cursor,
-        })));
-    server.tool("create_outcome", paidDescription("Create a new outcome.", mode.mode), {
-        name: z.string().min(1),
-        summary: z.string().optional(),
-        causalHypothesis: z.string().optional(),
-        suggestedAction: z.string().optional(),
-        idempotencyKey: idempotencyKeySchema,
-    }, async (payload) => {
-        if (mode.mode === "free")
-            return localResponse(paidFeatureNudge("create_outcome"));
-        return apiToolResponse("/api/outcomes", {
-            name: payload.name,
-            summary: payload.summary,
-            causalHypothesis: payload.causalHypothesis,
-            suggestedAction: payload.suggestedAction,
-        }, "POST", { idempotencyKey: payload.idempotencyKey });
-    });
-    server.tool("update_outcome", paidDescription("Update an outcome.", mode.mode), {
-        id: z.string().min(1),
-        name: z.string().min(1).optional(),
-        summary: z.string().optional(),
-        causalHypothesis: z.string().optional(),
-        suggestedAction: z.string().optional(),
-        status: z.enum(["active", "achieved", "abandoned", "archived"]).optional(),
-        idempotencyKey: idempotencyKeySchema,
-        echo: echoSchema,
-    }, async (payload) => {
-        if (mode.mode === "free")
-            return localResponse(paidFeatureNudge("update_outcome"));
-        const upstream = await postToServer(payload.echo === "full"
-            ? `/api/outcomes/${encodeURIComponent(payload.id)}`
-            : withResponseShape(`/api/outcomes/${encodeURIComponent(payload.id)}`), {
-            name: payload.name,
-            summary: payload.summary,
-            causalHypothesis: payload.causalHypothesis,
-            suggestedAction: payload.suggestedAction,
-            status: payload.status,
-        }, options, { method: "PATCH", idempotencyKey: payload.idempotencyKey });
-        const failure = upstreamFailure(upstream);
-        if (failure)
-            return localResponse(failure);
-        if (!payload.echo) {
-            return compactWriteResponse({ id: upstreamId(upstream) ?? payload.id, sequence: upstreamSequence(upstream) ?? 1 });
-        }
-        return localResponse(payload.echo === "summary"
-            ? { ok: true, id: upstreamId(upstream) ?? payload.id, sequence: upstreamSequence(upstream) ?? 1 }
-            : upstream);
-    });
-    server.tool("delete_outcome", paidDescription("Delete an outcome.", mode.mode), {
-        id: z.string().min(1),
-        confirmText: z.string().min(1),
-        idempotencyKey: idempotencyKeySchema,
-    }, async (payload) => {
-        if (mode.mode === "free")
-            return localResponse(paidFeatureNudge("delete_outcome"));
-        return apiToolResponse(`/api/outcomes/${encodeURIComponent(payload.id)}`, {
-            confirmText: payload.confirmText,
-        }, "DELETE", { idempotencyKey: payload.idempotencyKey });
-    });
-    server.tool("get_north_star", paidDescription("Read the workspace north-star metric.", mode.mode), {}, async () => mode.mode === "free"
-        ? localResponse(paidFeatureNudge("get_north_star"))
-        : apiToolResponse("/api/north-star"));
-    server.tool("update_north_star", paidDescription("Update the workspace north-star metric.", mode.mode), {
-        metric: z.string().min(1),
-        current: z.string().min(1),
-        target: z.string().min(1),
-        reason: z.string().min(1),
-        idempotencyKey: idempotencyKeySchema,
-    }, async (payload) => {
-        if (mode.mode === "free")
-            return localResponse(paidFeatureNudge("update_north_star"));
-        return apiToolResponse("/api/north-star", {
-            metric: payload.metric,
-            current: payload.current,
-            target: payload.target,
-            reason: payload.reason,
-        }, "POST", { idempotencyKey: payload.idempotencyKey });
-    });
     server.tool("list_signals", {
         limit: z.number().int().positive().max(300).optional(),
         cursor: z.string().optional(),
@@ -1131,217 +998,7 @@ export function createAskTheWMcpServer(options = {}) {
             max_chars: payload.max_chars ?? 8000,
         }));
     });
-    server.tool("find_signal_by_summary", "Find recent signals by summary text without needing an opaque signal id first.", {
-        query: z.string().min(1),
-        sessionId: z.string().optional(),
-        limit: z.number().int().positive().max(50).default(5),
-        compact: z.boolean().optional(),
-        max_chars: maxCharsSchema,
-    }, async (payload) => {
-        if (mode.mode !== "paid" && localStore) {
-            const loginRequired = requireFreeIdentity();
-            if (loginRequired)
-                return loginRequired;
-            const normalizedQuery = payload.query.toLowerCase();
-            const signals = localStore
-                .listSignals({
-                limit: 100000,
-                sessionId: payload.sessionId,
-                scopeKey: currentScopeKey(),
-            })
-                .filter((signal) => [
-                signal.summary,
-                signal.kind,
-                ...signal.filesTouched,
-                ...signal.commandsRun,
-            ].join("\n").toLowerCase().includes(normalizedQuery))
-                .slice(0, payload.limit);
-            return budgetedLocalResponse({
-                ok: true,
-                tier: "free",
-                query: payload.query,
-                signals: payload.compact === false
-                    ? signals.map((signal) => signalWithDecision(localStore, signal))
-                    : signals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id))),
-            }, payload.max_chars ?? 8000);
-        }
-        return apiToolResponse(routeWithQuery("/api/signals", {
-            query: payload.query,
-            sessionId: payload.sessionId,
-            limit: payload.limit,
-            compact: payload.compact ?? true,
-            max_chars: payload.max_chars ?? 8000,
-        }));
-    });
-    server.tool("get_signal", {
-        id: z.string().min(1),
-    }, async (payload) => {
-        if (mode.mode !== "paid" && localStore) {
-            const loginRequired = requireFreeIdentity();
-            if (loginRequired)
-                return loginRequired;
-            const signal = localStore.getSignal(Number(payload.id));
-            return signal
-                ? localResponse({ ok: true, tier: "free", signal: signalWithDecision(localStore, signal) })
-                : localToolError({
-                    code: "not_found",
-                    message: "Signal not found in the local Ask The W store.",
-                    retryable: false,
-                    hint: "Check the signal id or list local signals first.",
-                });
-        }
-        return apiToolResponse(`/api/signals/${encodeURIComponent(payload.id)}`);
-    });
-    server.tool("review_decisions", "Review captured decisions. Use for natural prompts like: What did I decide yesterday?", {
-        since: z.string().optional(),
-        status: z.enum(["proposed", "committed", "shipped", "abandoned"]).optional(),
-        format: z.enum(["markdown", "json"]).default("markdown"),
-        limit: z.number().int().positive().max(300).default(50),
-        cursor: cursorSchema,
-        sessionId: z.string().optional(),
-        compact: z.boolean().optional(),
-        max_chars: maxCharsSchema,
-    }, async (payload) => {
-        if (mode.mode === "paid") {
-            return apiToolResponse(routeWithQuery("/api/decisions", {
-                since: payload.since,
-                status: payload.status,
-                limit: payload.limit,
-                cursor: payload.cursor,
-                sessionId: payload.sessionId,
-                compact: payload.compact,
-                max_chars: payload.max_chars,
-            }));
-        }
-        if (!localStore) {
-            return localToolError({
-                code: "local_store_unavailable",
-                message: "The local Ask The W store is unavailable.",
-                retryable: true,
-                hint: "Retry after restarting the plugin host.",
-            });
-        }
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const decisions = localStore.listDecisions({
-            since: payload.since,
-            status: payload.status,
-            limit: payload.limit,
-            cursor: payload.cursor,
-            sessionId: payload.sessionId,
-            scopeKey: currentScopeKey(),
-        });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            format: payload.format,
-            rendered: renderDecisionDigest(decisions),
-            decisions: payload.compact
-                ? decisions.map((decision) => ({
-                    id: decision.id,
-                    headline: decision.headline,
-                    status: decision.status,
-                    signalIds: decision.sourceSignalIds,
-                }))
-                : decisions.map((decision) => decisionWithSignals(localStore, decision)),
-            count: decisions.length,
-            nextCursor: decisions.length >= payload.limit ? decisions.at(-1)?.createdAt ?? null : null,
-            copyHint: "Copy this output to back up your decisions - `export_decisions` is a paid feature.",
-        }, payload.max_chars);
-    });
-    server.tool("review_session", "Review the current session trail. Use for natural prompts like: Show me my session trail.", {
-        sessionId: z.string().optional(),
-        format: z.enum(["markdown", "json"]).default("markdown"),
-        cursor: cursorSchema,
-        limit: z.number().int().positive().max(50).default(50),
-        compact: z.boolean().optional(),
-        max_chars: maxCharsSchema,
-    }, async (payload) => {
-        if (!localStore || mode.mode === "paid") {
-            return apiToolResponse(routeWithQuery("/api/signals", {
-                sessionId: payload.sessionId,
-                cursor: payload.cursor,
-                limit: payload.limit,
-                compact: payload.compact,
-                max_chars: payload.max_chars,
-            }));
-        }
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const scopeKey = currentScopeKey();
-        const sessionId = payload.sessionId ?? localStore.mostRecentSessionId({ scopeKey });
-        const allSessionIds = localStore.listSessionIds({ limit: 100000, scopeKey });
-        const allowedSessionIds = new Set(allSessionIds.slice(0, 3));
-        if (sessionId && allSessionIds.length > 3 && !allowedSessionIds.has(sessionId)) {
-            return localToolError({
-                code: "free_tier_limit",
-                message: "The free plugin can review the latest three local sessions.",
-                retryable: false,
-                hint: "Upgrade to review more than three sessions in the workspace dashboard.",
-                extra: {
-                    tool: "review_session",
-                    limit: 3,
-                    upgradeUrl: "https://askthew.com/plugin?utm_source=mcp-plugin&utm_medium=tool-nudge&utm_campaign=mcp-free&tool=review_session",
-                    cta: "Upgrade to review more than three sessions in the workspace dashboard.",
-                },
-            });
-        }
-        const limit = Math.min(50, payload.limit ?? 50);
-        const signals = sessionId
-            ? localStore.listSignals({ sessionId, scopeKey, cursor: payload.cursor, limit })
-            : [];
-        const allSignals = sessionId ? localStore.listSignals({ sessionId, scopeKey, limit: 100000 }) : [];
-        const decisions = sessionId
-            ? localStore.listDecisions({ sessionId, scopeKey, limit: 100000 })
-            : [];
-        const decisionCandidates = listDecisionCandidates({ store: localStore, sessionId, scopeKey, limit: 25 }).candidates;
-        const counts = signals.reduce((accumulator, signal) => {
-            accumulator[signal.kind] = (accumulator[signal.kind] ?? 0) + 1;
-            return accumulator;
-        }, {});
-        const allCounts = allSignals.reduce((accumulator, signal) => {
-            accumulator[signal.kind] = (accumulator[signal.kind] ?? 0) + 1;
-            return accumulator;
-        }, {});
-        const nextCursor = signals.length >= limit ? signals.at(-1)?.capturedAt ?? null : null;
-        if (payload.format === "json") {
-            return budgetedLocalResponse({
-                ok: true,
-                tier: "free",
-                sessionId,
-                format: "json",
-                signals: payload.compact
-                    ? signals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id)))
-                    : signals.map((signal) => signalWithDecision(localStore, signal)),
-                decisions: payload.compact
-                    ? decisions.map((decision) => ({ id: decision.id, headline: decision.headline, status: decision.status, signalIds: decision.sourceSignalIds }))
-                    : decisions.map((decision) => decisionWithSignals(localStore, decision)),
-                decisionCandidates,
-                nextCursor,
-                counts: {
-                    totalSignals: allSignals.length,
-                    byKind: allCounts,
-                },
-            }, payload.max_chars);
-        }
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            sessionId,
-            format: "markdown",
-            rendered: renderSessionMarkdown({ sessionId, signals: allSignals, decisions, decisionCandidates }),
-            ...(payload.compact
-                ? { signals: allSignals.map((signal) => compactSignal(signal, localStore.getDecisionForSignal(signal.id))) }
-                : {}),
-            counts: {
-                totalSignals: allSignals.length,
-                byKind: Object.keys(allCounts).length ? allCounts : counts,
-            },
-        }, payload.max_chars);
-    });
-    server.tool("recap", "Summarize the latest local coding-agent session as a digest, standup, or share-ready recap.", {
+    server.tool("recap", "Get a concise recap of the latest local coding-agent session.", {
         format: z.enum(["digest", "standup", "share"]).default("digest"),
         sessionId: z.string().optional(),
         compact: z.boolean().optional(),
@@ -1352,6 +1009,9 @@ export function createAskTheWMcpServer(options = {}) {
         const loginRequired = requireFreeIdentity();
         if (loginRequired)
             return loginRequired;
+        const limited = consumeLimitedLocalUse("recap");
+        if (limited)
+            return limited;
         const scopeKey = currentScopeKey();
         const sessionId = payload.sessionId ?? localStore.mostRecentSessionId({ scopeKey });
         const signals = sessionId ? localStore.listSignals({ sessionId, scopeKey, limit: 100000 }) : [];
@@ -1367,19 +1027,18 @@ export function createAskTheWMcpServer(options = {}) {
                 : {}),
         }, payload.max_chars);
     });
-    server.tool("coach", "Coach the local coding-agent session. Use for natural prompts like: Coach me on this session.", {
-        scope: z.enum(["session", "week", "patterns"]).default("session"),
+    server.tool("coach", "Get one concise coaching nudge for the local coding-agent session.", {
         sessionId: z.string().optional(),
         max_chars: maxCharsSchema,
     }, async (payload) => {
-        if (payload.scope === "week" || payload.scope === "patterns") {
-            return localResponse(paidFeatureNudge("coach"));
-        }
         if (!localStore || mode.mode === "paid")
             return localResponse(paidFeatureNudge("coach"));
         const loginRequired = requireFreeIdentity();
         if (loginRequired)
             return loginRequired;
+        const limited = consumeLimitedLocalUse("coach");
+        if (limited)
+            return limited;
         const scopeKey = currentScopeKey();
         const sessionId = payload.sessionId ?? localStore.mostRecentSessionId({ scopeKey });
         const signals = sessionId ? localStore.listSignals({ sessionId, scopeKey, limit: 100000 }) : [];
@@ -1388,12 +1047,9 @@ export function createAskTheWMcpServer(options = {}) {
         return budgetedLocalResponse({
             ok: true,
             tier: "free",
-            scope: "session",
             sessionId,
-            qualityScore: coaching.qualityScore,
-            biggestGap: coaching.biggestGap,
-            failureMode: coaching.failureMode,
-            rendered: `Decision quality score: ${coaching.qualityScore}/100\nBiggest gap: ${coaching.biggestGap}`,
+            nudge: coaching.nudge,
+            rendered: coaching.nudge,
         }, payload.max_chars);
     });
     server.tool("promote_signal_to_decision", "Copy a captured signal summary into a linked local decision.", {
@@ -1427,6 +1083,21 @@ export function createAskTheWMcpServer(options = {}) {
                 extra: { tool: "promote_signal_to_decision" },
             });
         }
+        const linkedDecision = localStore.getDecisionForSignal(signal.id);
+        if (linkedDecision) {
+            const decision = localStore.updateDecision(linkedDecision.id, {
+                ...(payload.why !== undefined ? { why: payload.why } : {}),
+                status: payload.status,
+            }) ?? linkedDecision;
+            return localResponse({
+                ok: true,
+                id: decision.id,
+                sequence: localStore.stats().decisions,
+                decision: decisionWithSignals(localStore, decision),
+                linkedSignalId: signal.id,
+                reused: true,
+            });
+        }
         if (payload.idempotencyKey) {
             const existingId = localStore.getMeta(`idempotency:promote_signal_to_decision:${payload.idempotencyKey}`);
             if (existingId) {
@@ -1469,151 +1140,8 @@ export function createAskTheWMcpServer(options = {}) {
             warnings,
         });
     });
-    server.tool("list_decision_candidates", "List local signals that look like decision moments and can be promoted.", {
-        sessionId: z.string().optional(),
-        limit: z.number().int().positive().max(300).default(50),
-        cursor: cursorSchema,
-        max_chars: maxCharsSchema,
-    }, async (payload) => {
-        if (!localStore || mode.mode === "paid")
-            return localResponse(paidFeatureNudge("list_decision_candidates"));
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const scopeKey = currentScopeKey();
-        const sessionId = payload.sessionId ?? localStore.mostRecentSessionId({ scopeKey });
-        const result = listDecisionCandidates({
-            store: localStore,
-            sessionId,
-            scopeKey,
-            limit: payload.limit,
-            cursor: payload.cursor,
-        });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            sessionId,
-            decisionCandidates: result.candidates,
-            nextCursor: result.nextCursor,
-        }, payload.max_chars);
-    });
-    server.tool("search_trail", "Search local signals and decisions together.", {
-        query: z.string().min(1),
-        sessionId: z.string().optional(),
-        limit: z.number().int().positive().max(100).default(25),
-        cursor: cursorSchema,
-        compact: z.boolean().optional(),
-        max_chars: maxCharsSchema,
-    }, async (payload) => {
-        if (!localStore || mode.mode === "paid")
-            return localResponse(paidFeatureNudge("search_trail"));
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const result = searchTrail({
-            store: localStore,
-            query: payload.query,
-            scopeKey: currentScopeKey(),
-            sessionId: payload.sessionId,
-            limit: payload.limit,
-            cursor: payload.cursor,
-            compact: payload.compact,
-        });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            query: payload.query,
-            matches: result.matches,
-            nextCursor: result.nextCursor,
-        }, payload.max_chars);
-    });
-    server.tool("export_decisions", paidDescription("Export decisions from your workspace.", mode.mode), {
-        format: z.enum(["json", "markdown", "jsonl"]).default("json"),
-        cursor: cursorSchema,
-        limit: z.number().int().positive().max(300).optional(),
-        max_chars: maxCharsSchema,
-    }, async (payload) => mode.mode === "free"
-        ? localResponse(paidFeatureNudge("export_decisions"))
-        : apiToolResponse(routeWithQuery("/api/export/timeline", {
-            format: payload.format,
-            cursor: payload.cursor,
-            limit: payload.limit ?? 50,
-            max_chars: payload.max_chars ?? 8000,
-        })));
-    server.tool("view_timeline", "View signals and decisions counts bucketed by session, day, or month.", {
-        scope: z.enum(["day", "month", "session"]).default("day"),
-        range: z.enum(["7D", "30D", "90D", "12M", "CUSTOM"]).default("30D"),
-        start: z.string().optional(),
-        end: z.string().optional(),
-        limit: z.number().int().positive().max(300).optional(),
-        outcomeId: z.string().optional(),
-        decisionStatus: z.enum(["proposed", "committed", "shipped", "abandoned"]).optional(),
-        signalSource: z.string().optional(),
-        max_chars: maxCharsSchema,
-    }, async (payload) => {
-        if (mode.mode === "paid") {
-            return apiToolResponse(routeWithQuery("/api/analytics/timeline-counts", {
-                scope: payload.scope,
-                range: payload.range,
-                start: payload.start,
-                end: payload.end,
-                limit: payload.limit,
-                outcomeId: payload.outcomeId,
-                decisionStatus: payload.decisionStatus,
-                signalSource: payload.signalSource,
-            }));
-        }
-        if (!localStore) {
-            return localToolError({
-                code: "local_store_unavailable",
-                message: "The local Ask The W store is unavailable.",
-                retryable: true,
-                hint: "Retry after restarting the plugin host.",
-            });
-        }
-        const loginRequired = requireFreeIdentity();
-        if (loginRequired)
-            return loginRequired;
-        const scopeKey = currentScopeKey();
-        const points = buildLocalTimeline({
-            scope: payload.scope,
-            signals: localStore.listSignals({ scopeKey, limit: 100000 }),
-            decisions: localStore.listDecisions({ scopeKey, limit: 100000 }),
-            limit: payload.limit,
-        });
-        const totals = points.reduce((accumulator, point) => ({
-            signals: accumulator.signals + point.signalCount,
-            decisions: accumulator.decisions + point.decisionCount,
-        }), { signals: 0, decisions: 0 });
-        return budgetedLocalResponse({
-            ok: true,
-            tier: "free",
-            scope: payload.scope,
-            period: {
-                start: points[0]?.startedAt ?? points[0]?.x ?? "",
-                end: points.at(-1)?.endedAt ?? points.at(-1)?.x ?? "",
-                label: "Local timeline",
-                tz: "UTC",
-            },
-            points,
-            totals,
-            insights: buildLocalTimelineInsights(points),
-            narrative: `Local timeline: ${totals.signals} signals, ${totals.decisions} decisions.`,
-            markdownTable: renderLocalTimelineMarkdown(points, payload.scope),
-        }, payload.max_chars);
-    });
     return server;
 }
-function renderDecisionDigest(decisions) {
-    if (decisions.length === 0) {
-        return "# Decisions\n\nNo local decisions captured yet.";
-    }
-    return [
-        "# Decisions",
-        "",
-        ...decisions.map((decision) => [`## ${decision.headline}`, `- id: ${decision.id}`, `- status: ${decision.status}`, `- created: ${decision.createdAt}`, decision.why ? `- why: ${decision.why}` : "- why: not captured"].join("\n")),
-    ].join("\n\n");
-}
 function buildSessionCoach(input) {
     const verificationCount = input.signals.filter((signal) => signal.kind === "verification_result").length;
     const implementationCount = input.signals.filter((signal) => signal.kind === "implementation_update").length;
@@ -1623,61 +1151,20 @@ function buildSessionCoach(input) {
     const hasVerification = verificationCount > 0;
     const hasDecision = decisionCount > 0;
     const hasDirection = directionCount > 0;
-    const qualityScore = Math.max(0, Math.min(100, 35 +
-        Math.min(25, decisionCount * 12) +
-        (hasVerification ? 25 : 0) +
-        (hasDirection ? 10 : 0) -
-        Math.max(0, implementationCount - decisionCount) * 3));
-    const failureMode = implementationCount >= 3 && verificationCount === 0
+    const nudge = implementationCount >= 3 && verificationCount === 0
         ? `You captured ${implementationCount} implementation updates but no verification_result; run one check and capture it before ending.`
         : input.signals.length >= 6 && finalSummaryCount === 0
             ? `You captured ${input.signals.length} signals but no final_summary; close the session with the outcome and remaining risk.`
             : decisionCount === 0 && directionCount > 0
                 ? "Direction changed, but no decision was captured; promote the clearest direction_change signal."
-                : null;
-    const biggestGap = failureMode ?? (!hasDecision
-        ? "Promote the clearest captured signal into a decision before the trail goes stale."
-        : !hasVerification
-            ? "Capture one verification result so the decision trail records whether the work actually held."
-            : implementationCount > decisionCount * 3
-                ? "There are many implementation updates per decision; collapse the important why into one decision."
-                : "The trail is usable. Keep the next decision tied to a verification result.");
-    return { qualityScore, biggestGap, failureMode };
-}
-function renderSessionMarkdown(input) {
-    const counts = input.signals.reduce((accumulator, signal) => {
-        accumulator[signal.kind] = (accumulator[signal.kind] ?? 0) + 1;
-        return accumulator;
-    }, {});
-    const activeDecisions = input.decisions.filter((decision) => decision.status !== "abandoned");
-    const coaching = buildSessionCoach({
-        signals: input.signals.map((signal) => ({ ...signal, filesTouched: [], commandsRun: [] })),
-        decisions: input.decisions,
-    });
-    const lines = [
-        "# Session Review",
-        `Session: ${input.sessionId ?? "none"}`,
-        `Signals: ${input.signals.length}`,
-        `Signal kinds: ${Object.entries(counts).map(([kind, count]) => `${kind} ${count}`).join(", ") || "none"}`,
-        `Active decisions: ${activeDecisions.length}`,
-        `Coaching tip: ${coaching.biggestGap}`,
-        "",
-        "## Signals By Kind",
-        ...Object.entries(counts)
-            .sort(([left], [right]) => left.localeCompare(right))
-            .map(([kind, count]) => `- ${kind}: ${count}`),
-        "",
-        "## Decision Candidates",
-        ...(input.decisionCandidates?.length
-            ? input.decisionCandidates.slice(0, 10).map((candidate) => `- signal ${candidate.signalId}: ${candidate.summary} (${candidate.suggestedStatus})`)
-            : ["- none"]),
-        "",
-        "## Active Decisions",
-        ...(activeDecisions.length
-            ? activeDecisions.map((decision) => `- ${decision.headline} (${decision.status})${decision.why ? ` - ${decision.why}` : ""}`)
-            : ["- none"]),
-    ];
-    return lines.slice(0, 300).join("\n");
+                : !hasDecision
+                    ? "Promote the clearest captured signal into a decision before the trail goes stale."
+                    : !hasVerification
+                        ? "Capture one verification result so the decision trail records whether the work actually held."
+                        : implementationCount > decisionCount * 3
+                            ? "There are many implementation updates per decision; collapse the important why into one decision."
+                            : "The trail is usable. Keep the next decision tied to a verification result.";
+    return { nudge };
 }
 function decisionalWeight(signal) {
     const kindWeight = signal.kind === "direction_change" ? 4 : signal.kind === "verification_result" ? 3 : signal.kind === "implementation_update" ? 2 : 1;
@@ -1796,21 +1283,6 @@ function candidateFromSignal(signal, linkedDecision) {
         capturedAt: signal.capturedAt,
     };
 }
-function listDecisionCandidates(input) {
-    const signals = input.store.listSignals({
-        sessionId: input.sessionId ?? undefined,
-        scopeKey: input.scopeKey,
-        cursor: input.cursor,
-        limit: Math.max(1, Math.min(300, input.limit ?? 50)),
-    });
-    const candidates = signals
-        .map((signal) => candidateFromSignal(signal, input.store.getDecisionForSignal(signal.id)))
-        .filter((candidate) => Boolean(candidate));
-    return {
-        candidates,
-        nextCursor: signals.length >= (input.limit ?? 50) ? signals.at(-1)?.capturedAt ?? null : null,
-    };
-}
 function normalizedDecisionTerms(text) {
     const stop = new Set(["the", "and", "for", "with", "this", "that", "from", "into", "keep", "use", "adopt", "remove", "drop", "replace", "defer", "ship", "commit"]);
     return String(text ?? "")
@@ -1855,55 +1327,6 @@ function detectDecisionConflicts(input) {
         overlappingTerms: entry.overlap.slice(0, 5),
     }));
 }
-function searchTrail(input) {
-    const terms = String(input.query ?? "")
-        .toLowerCase()
-        .split(/\s+/)
-        .filter(Boolean);
-    const limit = Math.max(1, Math.min(100, input.limit ?? 25));
-    const haystackMatches = (value) => terms.every((term) => value.toLowerCase().includes(term));
-    const signals = input.store
-        .listSignals({ scopeKey: input.scopeKey, sessionId: input.sessionId ?? undefined, cursor: input.cursor, limit: 100000 })
-        .filter((signal) => haystackMatches([
-        signal.summary,
-        signal.kind,
-        signal.filesTouched.join(" "),
-        signal.commandsRun.join(" "),
-        JSON.stringify(signal.evidence),
-        JSON.stringify(signal.metadata),
-    ].join(" ")))
-        .map((signal) => ({
-        type: "signal",
-        id: String(signal.id),
-        createdAt: signal.capturedAt,
-        score: terms.length,
-        result: input.compact ? compactSignal(signal, input.store.getDecisionForSignal(signal.id)) : signalWithDecision(input.store, signal),
-    }));
-    const decisions = input.store
-        .listDecisions({ scopeKey: input.scopeKey, sessionId: input.sessionId ?? undefined, cursor: input.cursor, limit: 100000 })
-        .filter((decision) => haystackMatches([decision.headline, decision.why ?? "", decision.rawContent, decision.files.join(" "), decision.status].join(" ")))
-        .map((decision) => ({
-        type: "decision",
-        id: decision.id,
-        createdAt: decision.createdAt,
-        score: terms.length,
-        result: input.compact
-            ? {
-                id: decision.id,
-                headline: decision.headline,
-                status: decision.status,
-                signalIds: decision.sourceSignalIds,
-            }
-            : decisionWithSignals(input.store, decision),
-    }));
-    const matches = [...signals, ...decisions]
-        .sort((left, right) => right.createdAt.localeCompare(left.createdAt))
-        .slice(0, limit);
-    return {
-        matches,
-        nextCursor: matches.length >= limit ? matches.at(-1)?.createdAt ?? null : null,
-    };
-}
 const isDirectIndexExecution = Boolean(process.argv[1]) &&
     (() => {
         const modulePath = fileURLToPath(import.meta.url);
@@ -1919,7 +1342,7 @@ export async function runInitializeHandshake(input = {}) {
     const modulePath = input.entrypoint ?? fileURLToPath(import.meta.url);
     const child = spawn(process.execPath, [modulePath], {
         cwd: process.cwd(),
-        env: process.env,
+        env: input.env ?? process.env,
         stdio: ["pipe", "pipe", "pipe"],
     });
     let stdout = "";
@@ -1944,7 +1367,7 @@ export async function runInitializeHandshake(input = {}) {
     };
     child.stdin.write(`${JSON.stringify(initialize)}\n`);
     try {
-        await new Promise((resolve, reject) => {
+        return await new Promise((resolve, reject) => {
             const timeout = setTimeout(() => {
                 reject(new Error(`Timed out waiting for initialize response. stdout=${stdout} stderr=${stderr}`));
             }, input.timeoutMs ?? 3000);
@@ -1963,7 +1386,11 @@ export async function runInitializeHandshake(input = {}) {
                     reject(new Error(`Unexpected initialize response: ${JSON.stringify(response)}`));
                     return;
                 }
-                resolve();
+                resolve({
+                    serverInfoVersion: typeof response.result?.serverInfo?.version === "string"
+                        ? response.result.serverInfo.version
+                        : undefined,
+                });
             };
             child.stdout.on("data", check);
             child.once("exit", failOnExit);