@askthew/mcp-plugin 0.4.9 → 0.4.10

package/README.md

@@ -6,7 +6,7 @@ Connect a local coding agent to Ask The W. The fastest path is free and local-fi
 npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp install --host claude_code --free --email you@founder.com
 ```
 
-This captures decisions and session signals to `~/.askthew/store.sqlite` and lets your agent run `review_decisions`, `review_session`, `recap`, `coach`, and `promote_signal_to_decision` without onboarding into the web app.
+This captures decisions and session signals to `~/.askthew/store.sqlite` and lets your agent list the trail, keep decisions, and get limited local recap and coaching without onboarding into the web app.
 
 Founder-friendly promise: install from npm, then ask your coding agent to review the last session. You should see value in under 60 seconds.
 
@@ -19,7 +19,7 @@ This package runs a small MCP server that lets Codex, Claude Code, Cursor, and o
 - Adds marked project instructions so future coding-agent sessions know when to send Ask The W updates.
 - Free mode stores full-fidelity signals and decisions locally in SQLite.
 - Paid workspace mode sends a startup heartbeat so Ask The W can show the plugin as installed.
-- Exposes `capture_session_signal` plus v1 API tools for decisions, outcomes, signals, outcome detail graphs, and north star reads or updates.
+- Exposes a small MCP surface for capture, signals, decisions, recap, and coaching.
 - Redacts obvious secrets from summaries, evidence excerpts, commands, and metadata before sending.
 - Adds lightweight workspace metadata such as host type, repo name, app path, and server name.
 
@@ -27,10 +27,10 @@ This package runs a small MCP server that lets Codex, Claude Code, Cursor, and o
 
 - It does not send full transcripts by default.
 - It does not send local free-tier content to Ask The W unless you upgrade and run sync upload.
-- It does not link outcomes, score confidence, dedupe signals, or update the graph locally.
+- It does not expose internal workspace APIs through the plugin.
 - It does not include the Ask The W app, private server code, Supabase code, or internal analytics code.
 
-Ask The W performs inference, linking, approval state, dedupe, and outcome updates in the app.
+Ask The W keeps the local plugin focused on the trail your agent can use while it works.
 
 ## Free Local Install
 
@@ -183,15 +183,13 @@ The session-signal tool remains the main automatic capture path.
 
 Use compact summaries and short evidence excerpts. Do not send full transcripts. By default, write tools return compact responses; use `echo: "full"` only when you need the larger payload for debugging.
 
-The plugin also exposes v1 API tools that map to the app's authenticated routes:
+The plugin exposes a small public tool surface:
 
 | Tool | Purpose |
 |---|---|
-| `list_decisions`, `get_decision`, `create_decision`, `update_decision`, `delete_decision` | Work with decision feed entries. |
-| `review_session`, `recap`, `coach`, `promote_signal_to_decision`, `find_signal_by_summary` | Review local sessions, get session coaching, find recent evidence, and turn signals into decisions in free mode. |
-| `list_outcomes`, `get_outcome`, `list_outcome_signals`, `create_outcome`, `update_outcome`, `delete_outcome` | Work with outcomes and their linked signals. |
-| `get_north_star`, `update_north_star` | Read or update the workspace north star. API updates are allowed only for private workspaces. |
-| `list_signals`, `get_signal` | Read workspace signals. |
+| `capture_session_signal`, `list_signals` | Capture and list the local signal trail. |
+| `list_decisions`, `get_decision`, `create_decision`, `promote_signal_to_decision` | Keep the decisions worth remembering. |
+| `recap`, `coach` | Get up to three local recaps and three coaching nudges. After that, the plugin returns `Limit reached. Upgrade to the paid plan.` |
 
 Free PLG helpers:
 
@@ -202,7 +200,7 @@ npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp digest -
 
 The hook prompts when staged files recently had implementation signals but no linked decision. The weekly digest writes `~/Documents/askthew-digest-YYYY-WW.md`.
 
-API mutations are text-only and are recorded back into the workspace signal feed. Decision and outcome deletes require a `confirmText` value that exactly matches the stored decision headline or outcome name after whitespace normalization. North star delete is not available through the API.
+Decision writes are text-only and are recorded with the local trail.
 
 ## Troubleshooting
 

package/dist/index.js

@@ -11,7 +11,7 @@ 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 { 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() {
@@ -321,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)}`;
 }
@@ -622,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 } : {}),
@@ -666,88 +669,27 @@ export function createAskTheWMcpServer(options = {}) {
         }
         return null;
     };
-    const localSessionAnalysisResponse = (payload) => {
-        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 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 analyze the latest three local sessions.",
-                retryable: false,
-                hint: "Upgrade to review more than three sessions in the workspace dashboard.",
-                extra: {
-                    tool: "analyze_session",
-                    limit: 3,
-                    upgradeUrl: "https://askthew.com/plugin?utm_source=mcp-plugin&utm_medium=tool-nudge&utm_campaign=mcp-free&tool=analyze_session",
-                    cta: "Upgrade to analyze 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 ?? "markdown") === "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);
+    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);
         }
-        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);
+        localStore.setMeta(key, String(count + 1));
+        return null;
     };
     server.tool("capture_session_signal", {
         sessionId: z.string().min(1),
@@ -792,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,
@@ -808,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,
@@ -822,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.",
@@ -1003,179 +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) {
-            return localResponse(paidFeatureNudge("delete_decision"));
-        }
-        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(),
@@ -1213,109 +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) {
-            return localResponse(paidFeatureNudge("find_signal_by_summary"));
-        }
-        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 localResponse(paidFeatureNudge("review_decisions"));
-        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,
-            }));
-        }
-        return localResponse(paidFeatureNudge("review_decisions"));
-    });
-    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 (mode.mode !== "paid")
-            return localResponse(paidFeatureNudge("review_session"));
-        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,
-            }));
-        }
-        return localResponse(paidFeatureNudge("review_session"));
-    });
-    server.tool("analyze_session", "Analyze the latest local coding-agent session.", {
-        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,
-            }));
-        }
-        return localSessionAnalysisResponse(payload);
-    });
-    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(),
@@ -1326,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 }) : [];
@@ -1341,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 }) : [];
@@ -1362,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.", {
@@ -1401,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) {
@@ -1443,90 +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 (mode.mode !== "paid")
-            return localResponse(paidFeatureNudge("list_decision_candidates"));
-        return apiToolResponse(routeWithQuery("/api/signals/decision-candidates", {
-            sessionId: payload.sessionId,
-            limit: payload.limit,
-            cursor: payload.cursor,
-            max_chars: 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 (mode.mode !== "paid")
-            return localResponse(paidFeatureNudge("search_trail"));
-        return apiToolResponse(routeWithQuery("/api/search/trail", {
-            query: payload.query,
-            sessionId: payload.sessionId,
-            limit: payload.limit,
-            cursor: payload.cursor,
-            compact: payload.compact,
-            max_chars: 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,
-            }));
-        }
-        return localResponse(paidFeatureNudge("view_timeline"));
-    });
     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;
@@ -1536,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;
@@ -1709,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 ?? "")
@@ -1768,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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askthew/mcp-plugin",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "private": false,
   "description": "Ask The W plugin connector for local-first coding-agent decisions, signals, and review.",
   "type": "module",