@askthew/mcp-plugin 0.4.5 → 0.4.7

package/README.md

@@ -3,7 +3,7 @@
 Connect a local coding agent to Ask The W. The fastest path is free and local-first:
 
 ```bash
-npx -y --prefer-online @askthew/mcp-plugin@latest install --host claude_code --free --email you@founder.com
+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.
@@ -35,7 +35,7 @@ Ask The W performs inference, linking, approval state, dedupe, and outcome updat
 ## Free Local Install
 
 ```bash
-npx -y --prefer-online @askthew/mcp-plugin@latest install \
+npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp install \
   --host claude_code \
   --free \
   --email you@founder.com
@@ -50,7 +50,7 @@ Telemetry is aggregate-only and opt-out. Ask The W does not receive code, file c
 Use `refresh` when you want the latest installed MCP config and instruction blocks without touching local identity or local data:
 
 ```bash
-npx -y --prefer-online @askthew/mcp-plugin@latest refresh --host claude_code
+npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp refresh --host claude_code
 ```
 
 `refresh` preserves `~/.askthew/identity.json` and `~/.askthew/store.sqlite`, reuses any existing email claim silently, rewrites the host MCP config, and rewrites the marked Ask The W blocks in `CLAUDE.md` and `AGENTS.md`. This is the recommended QA update path after a plugin publish.
@@ -72,7 +72,7 @@ Use setup tokens promptly. They expire after 24 hours if the connector never sen
 Codex:
 
 ```bash
-npx -y --prefer-online @askthew/mcp-plugin@latest install \
+npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp install \
   --host codex \
   --token "<ASKTHEW_INSTALL_TOKEN>" \
   --api-url "https://app.askthew.com/" \
@@ -82,7 +82,7 @@ npx -y --prefer-online @askthew/mcp-plugin@latest install \
 Claude Code:
 
 ```bash
-npx -y --prefer-online @askthew/mcp-plugin@latest install \
+npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp install \
   --host claude_code \
   --token "<ASKTHEW_INSTALL_TOKEN>" \
   --api-url "https://app.askthew.com/" \
@@ -92,7 +92,7 @@ npx -y --prefer-online @askthew/mcp-plugin@latest install \
 Cursor:
 
 ```bash
-npx -y --prefer-online @askthew/mcp-plugin@latest install \
+npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp install \
   --host cursor \
   --token "<ASKTHEW_INSTALL_TOKEN>" \
   --api-url "https://app.askthew.com/" \
@@ -130,7 +130,7 @@ Codex example:
 ```toml
 [mcp_servers.askthew]
 command = "npx"
-args = ["-y", "--prefer-online", "@askthew/mcp-plugin@latest"]
+args = ["-y", "--prefer-online", "--package", "@askthew/mcp-plugin@latest", "askthew-mcp"]
 env = { ASKTHEW_INSTALL_TOKEN = "<ASKTHEW_INSTALL_TOKEN>", ASKTHEW_HOST_TYPE = "codex", ASKTHEW_API_URL = "https://app.askthew.com/", ASKTHEW_SERVER_NAME = "askthew" }
 ```
 
@@ -194,8 +194,8 @@ The plugin also exposes v1 API tools that map to the app's authenticated routes:
 Free PLG helpers:
 
 ```bash
-npx @askthew/mcp-plugin install-hook --pre-commit
-npx @askthew/mcp-plugin digest --weekly
+npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp install-hook --pre-commit
+npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp digest --weekly
 ```
 
 The hook prompts when staged files recently had implementation signals but no linked decision. The weekly digest writes `~/Documents/askthew-digest-YYYY-WW.md`.

package/dist/cli.js

@@ -5,7 +5,7 @@ import path from "node:path";
 import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { createAskTheWMcpServer } from "./index.js";
-import { ensureAskTheWDataDir, identityPath } from "./lib/paths.js";
+import { askTheWDataDir, ensureAskTheWDataDir, identityPath } from "./lib/paths.js";
 import { loadCliCredentials } from "./lib/free-tier-policy.js";
 import { describeFreeIdentity, tryRegisterFreeInstall } from "./lib/free-install-registration.js";
 import { ensureLocalIdentity, loadLocalIdentity, publicIdentity } from "./lib/local-identity.js";
@@ -348,21 +348,39 @@ async function runUninstallCommand(argv) {
     const instructions = keepAgentInstructions
         ? null
         : uninstallBehaviorInstructions({ hostType, dryRun });
+    const dataDir = askTheWDataDir();
+    const hadLocalData = fs.existsSync(dataDir);
+    const authFile = identityPath();
+    const hadAuth = fs.existsSync(authFile);
     if (!keepLocalData && !dryRun) {
-        fs.rmSync(ensureAskTheWDataDir(), { recursive: true, force: true });
+        fs.rmSync(dataDir, { recursive: true, force: true });
     }
     if (!keepAuth && !dryRun) {
-        const file = identityPath();
-        if (fs.existsSync(file))
-            fs.rmSync(file, { force: true });
+        if (fs.existsSync(authFile))
+            fs.rmSync(authFile, { force: true });
     }
     console.log(dryRun ? "Ask The W plugin uninstall dry run complete." : "Ask The W plugin uninstall complete.");
     console.log(`Settings path: ${config.settingsPath}`);
+    console.log(config.removedServer
+        ? `${dryRun ? "Would remove" : "Removed"} MCP server "${config.removedServerName}".`
+        : config.foundConfigFile
+            ? `No MCP server "${config.removedServerName}" found in host config.`
+            : "No host config file found.");
     if (instructions) {
-        console.log(`Agent instructions removed: ${instructions.paths.join(", ") || "none"}`);
-    }
-    console.log(keepLocalData ? "Local data kept." : "Local data removed.");
-    console.log(keepAuth ? "Auth tokens kept." : "Auth tokens removed.");
+        console.log(instructions.paths.length > 0
+            ? `Agent instructions ${dryRun ? "would be removed from" : "removed from"}: ${instructions.paths.join(", ")}`
+            : "No Ask The W agent instruction blocks found.");
+    }
+    console.log(keepLocalData
+        ? "Local data kept."
+        : hadLocalData
+            ? `${dryRun ? "Local data would be removed" : "Local data removed"}.`
+            : "No local data directory found.");
+    console.log(keepAuth
+        ? "Auth tokens kept."
+        : hadAuth
+            ? `${dryRun ? "Local identity would be removed" : "Local identity removed"}.`
+            : "No local identity found.");
     if (dryRun) {
         console.log("");
         console.log(config.json);
@@ -559,7 +577,7 @@ async function runHookCheckCommand(argv) {
     const gap = preCommitDecisionGap({ store, stagedFiles: stagedFiles(), scopeKey: localScopeKey() });
     if (gap.missing) {
         console.log('Ask The W: this change has no decision attached, draft one?');
-        console.log("Run: npx @askthew/mcp-plugin digest --weekly or ask your agent to call promote_signal_to_decision.");
+        console.log("Run: npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp digest --weekly or ask your agent to call promote_signal_to_decision.");
     }
 }
 async function runDigestCommand(argv) {
@@ -587,7 +605,17 @@ async function runSyncCommand(argv) {
     }
     console.log(JSON.stringify(await uploadLocalStore({ store, credentials, syncToken }), null, 2));
 }
-const isDirectCliExecution = Boolean(process.argv[1]) && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+const isDirectCliExecution = Boolean(process.argv[1]) &&
+    (() => {
+        const cliPath = fileURLToPath(import.meta.url);
+        const invokedPath = path.resolve(process.argv[1]);
+        try {
+            return fs.realpathSync(invokedPath) === fs.realpathSync(cliPath);
+        }
+        catch {
+            return invokedPath === cliPath;
+        }
+    })();
 if (isDirectCliExecution) {
     main().catch((error) => {
         if (error instanceof Error) {

package/dist/index.js

@@ -1,4 +1,8 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { z } from "zod";
 import { resolvePluginScope } from "./scope.js";
 import { resolveMcpMode } from "./lib/free-tier-policy.js";
@@ -482,10 +486,10 @@ function loginCommandHint() {
     ]) {
         const email = String(value ?? "").trim();
         if (/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email)) {
-            return `npx @askthew/mcp-plugin identify --email ${email}`;
+            return `npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp identify --email ${email}`;
         }
     }
-    return "npx @askthew/mcp-plugin identify --email <your-email>";
+    return "npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp identify --email <your-email>";
 }
 async function sendStartupHeartbeat(options) {
     if (!hasServerIdentity(options?.credentials)) {
@@ -565,7 +569,7 @@ export function createAskTheWMcpServer(options = {}) {
     }
     const server = new McpServer({
         name: "Ask The W Coding Agent Connector",
-        version: "0.4.0",
+        version: "0.4.7",
     });
     if (options.sendStartupHeartbeat !== false && mode.mode === "paid") {
         void sendStartupSignals(options);
@@ -1899,3 +1903,27 @@ function searchTrail(input) {
         nextCursor: matches.length >= limit ? matches.at(-1)?.createdAt ?? null : null,
     };
 }
+const isDirectIndexExecution = Boolean(process.argv[1]) &&
+    (() => {
+        const modulePath = fileURLToPath(import.meta.url);
+        const invokedPath = path.resolve(process.argv[1]);
+        try {
+            return fs.realpathSync(invokedPath) === fs.realpathSync(modulePath);
+        }
+        catch {
+            return invokedPath === modulePath;
+        }
+    })();
+if (isDirectIndexExecution) {
+    const server = createAskTheWMcpServer();
+    const transport = new StdioServerTransport();
+    server.connect(transport).catch((error) => {
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        else {
+            console.error("Ask The W MCP server failed to start.", error);
+        }
+        process.exit(1);
+    });
+}

package/dist/install.d.ts

@@ -111,6 +111,8 @@ export declare function uninstallHostConfig(input: UninstallHostConfigInput): {
     settingsPath: string;
     json: string;
     removedServerName: string;
+    foundConfigFile: boolean;
+    removedServer: boolean;
     wroteFile: boolean;
 };
 export declare function sendInstallHeartbeat(input: HostConfigInput & {

package/dist/install.js

@@ -21,7 +21,7 @@ export function createServerEntry(input) {
     const scope = resolvePluginScope(input.cwd ?? process.cwd());
     return {
         command: "npx",
-        args: ["-y", "--prefer-online", "@askthew/mcp-plugin@latest"],
+        args: ["-y", "--prefer-online", "--package", "@askthew/mcp-plugin@latest", "askthew-mcp"],
         env: {
             ASKTHEW_API_URL: input.apiUrl,
             ...(input.free ? { ASKTHEW_FREE_MODE: "1" } : { ASKTHEW_INSTALL_TOKEN: input.token ?? "" }),
@@ -133,24 +133,23 @@ export function formatInstallCommand(input) {
         "npx",
         "-y",
         "--prefer-online",
+        "--package",
         "@askthew/mcp-plugin@latest",
+        "askthew-mcp",
         "install",
         "--host",
         input.hostType,
+        ...(input.free ? ["--free"] : ["--token", JSON.stringify(input.token ?? "")]),
         "--api-url",
         JSON.stringify(input.apiUrl),
         "--server-name",
         JSON.stringify(input.serverName),
     ];
     if (input.free) {
-        parts.push("--free");
         if (input.email) {
             parts.push("--email", JSON.stringify(input.email));
         }
     }
-    else {
-        parts.splice(7, 0, "--token", JSON.stringify(input.token ?? ""));
-    }
     return parts.join(" ");
 }
 export function verificationNextStep(hostType) {
@@ -219,9 +218,13 @@ export function uninstallHostConfig(input) {
     });
     const serverName = input.serverName?.trim() || "askthew";
     let json = "";
+    let foundConfigFile = false;
+    let removedServer = false;
     if (fs.existsSync(settingsPath)) {
+        foundConfigFile = true;
         const raw = fs.readFileSync(settingsPath, "utf8");
         if (input.hostType === "codex") {
+            removedServer = raw !== removeCodexTomlServer(raw, serverName) || (serverName !== "askthew" && raw !== removeCodexTomlServer(raw, "askthew"));
             json = removeCodexTomlServer(raw, serverName);
             if (serverName !== "askthew") {
                 json = removeCodexTomlServer(json, "askthew");
@@ -236,6 +239,7 @@ export function uninstallHostConfig(input) {
                 const existingProject = isRecord(existingProjects[cwd]) ? existingProjects[cwd] : {};
                 const existingMcpServers = isRecord(existingProject.mcpServers) ? existingProject.mcpServers : {};
                 const nextServers = { ...existingMcpServers };
+                removedServer = serverName in nextServers || (serverName !== "askthew" && "askthew" in nextServers);
                 delete nextServers[serverName];
                 if (serverName !== "askthew")
                     delete nextServers.askthew;
@@ -253,6 +257,7 @@ export function uninstallHostConfig(input) {
             else {
                 const existingMcpServers = isRecord(parsed.mcpServers) ? parsed.mcpServers : {};
                 const nextServers = { ...existingMcpServers };
+                removedServer = serverName in nextServers || (serverName !== "askthew" && "askthew" in nextServers);
                 delete nextServers[serverName];
                 if (serverName !== "askthew")
                     delete nextServers.askthew;
@@ -268,7 +273,9 @@ export function uninstallHostConfig(input) {
         settingsPath,
         json,
         removedServerName: serverName,
-        wroteFile: !input.dryRun,
+        foundConfigFile,
+        removedServer,
+        wroteFile: !input.dryRun && foundConfigFile,
     };
 }
 export async function sendInstallHeartbeat(input) {

package/dist/lib/cli-actions.js

@@ -22,7 +22,7 @@ export function installPreCommitHook(input = {}) {
     const hook = [
         "#!/bin/sh",
         "# Ask The W pre-commit decision prompt",
-        "npx -y --prefer-online @askthew/mcp-plugin@latest hook-check --pre-commit",
+        "npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp hook-check --pre-commit",
         "",
     ].join("\n");
     fs.mkdirSync(path.dirname(hookPath), { recursive: true });

package/dist/lib/telemetry.js

@@ -27,7 +27,7 @@ export function buildTelemetryPayload(input) {
         decisions: decisionStats(decisions),
         tools: input.toolUsage ?? {},
         plugin: {
-            version: "0.4.0",
+            version: "0.4.7",
             platform: `${process.platform}-${process.arch}`,
             node: process.version.replace(/^v/, ""),
         },

package/dist/lib/upgrade-nudge.js

@@ -22,7 +22,7 @@ export function paidFeatureNudge(tool) {
         pricingUrl: PRICING_URL,
         upgradeUrl: `https://askthew.com/plugin?utm_source=mcp-plugin&utm_medium=tool-nudge&utm_campaign=mcp-free&tool=${encodeURIComponent(tool)}`,
         supportEmail: SUPPORT_EMAIL,
-        cta: "Run: npx @askthew/mcp-plugin upgrade",
+        cta: "Run: npx -y --prefer-online --package @askthew/mcp-plugin@latest askthew-mcp upgrade",
     };
 }
 export function toolJson(value) {

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@askthew/mcp-plugin",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "private": false,
   "description": "Ask The W plugin connector for local-first coding-agent decisions, signals, and review.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "askthew-mcp": "dist/cli.js"
+    "askthew-mcp": "dist/cli.js",
+    "mcp-plugin": "dist/cli.js"
   },
   "files": [
     "README.md",
     "dist/**/*.d.ts",
-    "dist/**/*.js"
+    "dist/**/*.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js"
   ],
   "keywords": [
     "askthew",

package/dist/cli-actions.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli-actions.test.js

@@ -1,71 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { execFileSync } from "node:child_process";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { LocalStore } from "./lib/local-store.js";
-import { buildWeeklyDigest, installPreCommitHook, preCommitDecisionGap, writeWeeklyDigest, } from "./lib/cli-actions.js";
-test("pre-commit gap detects staged implementation updates without linked decisions", () => {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "askthew-hook-store-"));
-    const store = LocalStore.open({ path: path.join(dir, "store.sqlite") });
-    const signal = store.insertSignal({
-        sessionId: "s1",
-        sequence: 1,
-        kind: "implementation_update",
-        summary: "Changed onboarding page.",
-        filesTouched: ["apps/app/page.tsx"],
-        commandsRun: [],
-    });
-    const gap = preCommitDecisionGap({
-        store,
-        stagedFiles: ["apps/app/page.tsx"],
-        now: new Date(signal.capturedAt),
-    });
-    assert.equal(gap.missing, true);
-    assert.deepEqual(gap.matchedSignals, [signal.id]);
-    store.createDecision({
-        rawContent: "Keep onboarding page copy direct.",
-        sessionId: "s1",
-        sourceSignalIds: [signal.id],
-    });
-    const resolved = preCommitDecisionGap({
-        store,
-        stagedFiles: ["apps/app/page.tsx"],
-        now: new Date(signal.capturedAt),
-    });
-    assert.equal(resolved.missing, false);
-    store.close();
-    fs.rmSync(dir, { recursive: true, force: true });
-});
-test("pre-commit hook installer writes the documented inline prompt hook", () => {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "askthew-hook-install-"));
-    execFileSync("git", ["init"], { cwd: dir, stdio: "ignore" });
-    const hookPath = installPreCommitHook({ cwd: dir });
-    const hook = fs.readFileSync(hookPath, "utf8");
-    assert.match(hook, /Ask The W pre-commit decision prompt/);
-    assert.match(hook, /@askthew\/mcp-plugin@latest hook-check --pre-commit/);
-    assert.equal((fs.statSync(hookPath).mode & 0o111) > 0, true);
-    fs.rmSync(dir, { recursive: true, force: true });
-});
-test("weekly digest writes markdown with documented footer", () => {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "askthew-digest-store-"));
-    const outDir = fs.mkdtempSync(path.join(os.tmpdir(), "askthew-digest-out-"));
-    const store = LocalStore.open({ path: path.join(dir, "store.sqlite") });
-    store.createDecision({
-        rawContent: "Ship the free-tier polish.",
-        sessionId: "s1",
-        status: "committed",
-    });
-    const now = new Date("2026-05-06T12:00:00.000Z");
-    const digest = buildWeeklyDigest({ store, now });
-    assert.match(digest, /# Ask The W Weekly Decision Digest 2026-19/);
-    assert.match(digest, /Ship the free-tier polish/);
-    assert.match(digest, /_Captured by Ask The W\._/);
-    const filePath = writeWeeklyDigest({ store, now, outputDir: outDir });
-    assert.equal(path.basename(filePath), "askthew-digest-2026-19.md");
-    assert.match(fs.readFileSync(filePath, "utf8"), /_Captured by Ask The W\._/);
-    store.close();
-    fs.rmSync(dir, { recursive: true, force: true });
-    fs.rmSync(outDir, { recursive: true, force: true });
-});

package/dist/cli.test.d.ts

@@ -1 +0,0 @@
-export {};