chain-insights 0.57.5 → 0.57.7

package/README.md

@@ -37,7 +37,9 @@ cia mcp tools                      # list remote graph tools
 Sixty seconds gets you the CLI, a network overview, and the available remote
 graph tools for Robinhood.
 To call the same tools from an agent, register the MCP proxy:
-`cia setup claude-code` (or `claude-desktop` / `codex` / `hermes`).
+`cia setup claude-code` (or `claude-desktop` / `codex` / `chatgpt` / `hermes`).
+The `chatgpt` target is for Codex chats inside the ChatGPT app: ask there,
+not in a plain ChatGPT chat.
 
 CLI results are human-readable by default. Add `--json` when another tool or
 script needs indented JSON:
@@ -61,35 +63,20 @@ the balance), and reaches the Chain Insights Graph for the data.
 - **Cannot start it:** claude.ai on the web, the Claude mobile apps and Cowork
   cloud sessions. They run no program on your computer.
 
-The plugin needs Node.js 22 or newer. Add this repository as a plugin
-marketplace, then install the `chain-insights` plugin from it.
-
-Without the plugin, register the installed proxy in Claude Desktop directly:
-
-1. Quit Claude Desktop fully. Closing the window is not enough: it keeps
-   running and writes its settings file back, which can remove the new entry.
-   - macOS: Claude menu > Quit Claude (Cmd+Q).
-   - Windows: right-click the Claude icon in the taskbar tray > Quit.
-   - Linux: File menu > Quit, or the tray icon > Quit.
-2. Run `npm install -g chain-insights`, then `cia setup claude-desktop`.
-   It warns if Claude Desktop is still running.
-3. Start Claude Desktop. `chain-insights` shows under Settings > Developer.
+In Claude Code the plugin also ships a Stop hook that checks every answer
+against the Chain Insights answer rules (full addresses, tokens are not
+dollars) and sends the model back once when one is broken.
 
-The entry is written to `claude_desktop_config.json` under `mcpServers`:
-`~/Library/Application Support/Claude` on macOS, `%APPDATA%\Claude` on
-Windows, `~/.config/Claude` on Linux. A `.bak` copy of the previous file is
-kept beside it.
-
-The plugin skills are copies of `skills/`. After editing a skill, run
-`node scripts/sync-plugin-skills.mjs`; a test fails while the copies differ.
+The plugin needs Node.js 22 or newer. Add this repository as a plugin
+marketplace, then install the `chain-insights` plugin from it. Setup for
+Claude Desktop without the plugin, and the plugin's own layout, are in
+[plugin/README.md](plugin/README.md).
 
 ## Purpose And Ownership
 
 One public npm package (`chain-insights`) providing the `cia` CLI and a
 stdio MCP proxy over a Chain Insights Graph endpoint.
 
-Owning group: chainswarm org, infra group.
-
 ## What It Does
 
 Owns:
@@ -119,7 +106,9 @@ Never touches:
 | `graph_query_batch`         | Run related read-only graph queries as one MCP call                                |
 | `meta_network_capabilities` | Check supported Chain Insights networks and graph tools                            |
 | `meta_schema`               | Read the live graph schema of a network: labels, link types, fields, indexes       |
-| `meta_usage_status`         | Check the caller's daily free-demo graph query allowance                           |
+| `meta_usage_status`         | Check the caller's daily free-tier graph query allowance                           |
+| `meta_subscription_status`  | Check the caller's $CIA subscription window and allowance                          |
+| `meta_rules`                | Read the answer rules when the `chain-insights-cypher` skill is not loaded         |
 | `meta_help`                 | Show Chain Insights tool and workflow guidance                                     |
 | `wallet_balance`            | Show the local payment wallet amount                                               |
 | `wallet_topup`              | Show the local payment wallet address and its QR code for a USDC top-up on Base    |
@@ -349,24 +338,8 @@ first, then paid access continues automatically.
 
 ## Test
 
-Local gate, in order:
-
-```bash
-npm run typecheck
-npm run build
-npm test
-npm run release:check   # PR-only step in verify.yml
-```
-
-CI install step, when reproducing CI:
-
-```bash
-npm ci --ignore-scripts --audit=false --fund=false
-```
-
-CI workflows: `.github/workflows/verify.yml` (typecheck, build,
-release:check, tests, npm pack contents), `security.yml`, `scorecard.yml`,
-`docs.yml`.
+The local gate, the CI install step and the workflows are in
+[docs/development.md](docs/development.md).
 
 ## Debug
 
@@ -394,6 +367,9 @@ cia mcp tools --refresh
 # Installed CLI sanity
 cia --version && cia update --check
 
+# Endpoint, wallet and access mode in one view
+cia status
+
 ```
 
 If network or tool discovery fails, check the endpoint and access mode
@@ -402,13 +378,8 @@ the command.
 
 ## Pre-staging / Release
 
-Every pull request to `main` must bump `package.json` and
-`package-lock.json`, add a matching `CHANGELOG.md` entry, and pass the GitHub
-verification checks. Before pre-staging or release, run the full local gate
-and confirm the release metadata is consistent.
-
-See [Release Discipline](docs/contributing.md#release-discipline) for the
-complete contributor requirements.
+Contributor rules, the version bump and the changelog entry every pull
+request carries: [Release Discipline](docs/contributing.md#release-discipline).
 
 ## Documentation Links
 

package/dist/cli.cjs

@@ -162,66 +162,6 @@ async function printNetworkSchema(name, opts) {
 	});
 	console.log(opts.json ? JSON.stringify(schema, null, 2) : formatGraphSchemaText(schema));
 }
-/**
-* Fetches the caller's subscription facts for the deposit pre-sign guard.
-* The extension math is server-authoritative: the printed values come from
-* `subscription_status`. Any failure (no wallet, unreachable endpoint,
-* missing tool, error result) degrades to an unavailable lookup — the guard
-* must never block the flow on a server that lacks the tool.
-*/
-async function fetchSubscriptionStatusForCli() {
-	try {
-		const { getWalletAccount } = await Promise.resolve().then(() => require("./tools-BHfphgy9.cjs")).then((n) => n.tools_exports);
-		const account = await getWalletAccount();
-		return await withGraphMcpClient("chain-insights-cli-subscription-status", async (client) => {
-			const result = await client.callTool({
-				name: "subscription_status",
-				arguments: { wallet: account.address }
-			});
-			const { parseSubscriptionStatusToolResult } = await Promise.resolve().then(() => require("./subscription-status-Cm7LqY_h.cjs")).then((n) => n.subscription_status_exports);
-			const facts = parseSubscriptionStatusToolResult(result);
-			if (!facts) return {
-				kind: "unavailable",
-				reason: "the graph endpoint returned no subscription facts"
-			};
-			return {
-				kind: "available",
-				facts
-			};
-		});
-	} catch (err) {
-		return {
-			kind: "unavailable",
-			reason: err.message
-		};
-	}
-}
-async function printSubscriptionPassGuidance(pass) {
-	const { formatDepositGuardLine, formatDepositIrreversibilityWarning, formatSubscriptionPassHint, isDepositConfirmed, resolveSubscriptionMonthUsd } = await Promise.resolve().then(() => require("./subscription-status-Cm7LqY_h.cjs")).then((n) => n.subscription_status_exports);
-	const hint = formatSubscriptionPassHint(pass, resolveSubscriptionMonthUsd());
-	const status = await fetchSubscriptionStatusForCli();
-	if (status.kind === "available") {
-		process.stderr.write(`${formatDepositGuardLine(status.facts, pass)}\n`);
-		process.stderr.write("The no-admin subscription sink cannot refund deposits. Type DEPOSIT to continue:\n");
-		const { createInterface } = await import("node:readline/promises");
-		const prompt = createInterface({
-			input: process.stdin,
-			output: process.stderr
-		});
-		let answer;
-		try {
-			answer = await prompt.question("> ");
-		} finally {
-			prompt.close();
-		}
-		process.stderr.write("\n");
-		if (!isDepositConfirmed(answer)) throw new Error("Deposit cancelled. No deposit was made.");
-		console.log(hint);
-		return;
-	}
-	process.stderr.write(`${formatDepositIrreversibilityWarning(status.reason)}\n`);
-	console.log(hint);
-}
 function addAmlAddressRiskCommand(parent, networksCommand) {
 	parent.addCommand(createCliCommand("aml-address-risk").description("CIA workflow: screen an address for AML risk, exchange behavior, and optional comparison with another address").requiredOption("--address <address>", "Full blockchain address to screen").requiredOption("--network <network>", `Network to query. Run \`${networksCommand}\` for supported networks.`).option("--compare-address <address>", "Optional second address to compare against the screened address").option("--json", "Print machine-readable JSON output").option("--version <version>", "AML tool contract version. Omit to use the latest version (currently v1)").addOption(new commander.Option("--tool-version <version>", "Internal alias for the AML tool version").hideHelp()).action(async (opts) => {
 		try {
@@ -548,21 +488,6 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		process.exit(1);
 	}
 }));
-program.command("buy").description("Show CIA subscription pass deposit guidance (the sink cannot refund deposits)").addCommand(createCliCommand("day").description("Show day-pass deposit guidance (SUBSCRIPTION_MONTH_USD / 30)").action(async () => {
-	try {
-		await printSubscriptionPassGuidance("day");
-	} catch (err) {
-		console.error(err.message);
-		process.exit(1);
-	}
-})).addCommand(createCliCommand("month").description("Show month-pass deposit guidance at the list price").action(async () => {
-	try {
-		await printSubscriptionPassGuidance("month");
-	} catch (err) {
-		console.error(err.message);
-		process.exit(1);
-	}
-}));
 program.command("mcp").description("Low-level access to the Chain Insights MCP endpoint").allowExcessArguments(false).addCommand(createCliCommand("networks").description("List the detailed Chain Insights capability matrix and tool support").option("--json", "Print raw capability JSON").action(async (opts) => {
 	try {
 		await printNetworkCapabilities(opts);
@@ -661,7 +586,7 @@ program.command("mcp").description("Low-level access to the Chain Insights MCP e
 						json: opts.json
 					});
 				} catch (err) {
-					const { isMissingSubscriptionStatusToolError, unavailableSubscriptionStatus, subscriptionStatusText } = await Promise.resolve().then(() => require("./subscription-status-Cm7LqY_h.cjs")).then((n) => n.subscription_status_exports);
+					const { isMissingSubscriptionStatusToolError, unavailableSubscriptionStatus, subscriptionStatusText } = await Promise.resolve().then(() => require("./subscription-status-ru99UCPZ.cjs")).then((n) => n.subscription_status_exports);
 					if (!isMissingSubscriptionStatusToolError(err)) throw err;
 					const { resolveGraphMcpEndpoint } = await Promise.resolve().then(() => require("./client-Ypw9BNbn.cjs")).then((n) => n.client_exports);
 					console.log(subscriptionStatusText(unavailableSubscriptionStatus(resolveGraphMcpEndpoint(config), `subscription_status failed: ${err.message}`)));

package/dist/cli.mjs

@@ -160,66 +160,6 @@ async function printNetworkSchema(name, opts) {
 	});
 	console.log(opts.json ? JSON.stringify(schema, null, 2) : formatGraphSchemaText(schema));
 }
-/**
-* Fetches the caller's subscription facts for the deposit pre-sign guard.
-* The extension math is server-authoritative: the printed values come from
-* `subscription_status`. Any failure (no wallet, unreachable endpoint,
-* missing tool, error result) degrades to an unavailable lookup — the guard
-* must never block the flow on a server that lacks the tool.
-*/
-async function fetchSubscriptionStatusForCli() {
-	try {
-		const { getWalletAccount } = await import("./tools-BnThuvE2.mjs").then((n) => n.p);
-		const account = await getWalletAccount();
-		return await withGraphMcpClient("chain-insights-cli-subscription-status", async (client) => {
-			const result = await client.callTool({
-				name: "subscription_status",
-				arguments: { wallet: account.address }
-			});
-			const { parseSubscriptionStatusToolResult } = await import("./subscription-status-CJ-DaMW9.mjs").then((n) => n.t);
-			const facts = parseSubscriptionStatusToolResult(result);
-			if (!facts) return {
-				kind: "unavailable",
-				reason: "the graph endpoint returned no subscription facts"
-			};
-			return {
-				kind: "available",
-				facts
-			};
-		});
-	} catch (err) {
-		return {
-			kind: "unavailable",
-			reason: err.message
-		};
-	}
-}
-async function printSubscriptionPassGuidance(pass) {
-	const { formatDepositGuardLine, formatDepositIrreversibilityWarning, formatSubscriptionPassHint, isDepositConfirmed, resolveSubscriptionMonthUsd } = await import("./subscription-status-CJ-DaMW9.mjs").then((n) => n.t);
-	const hint = formatSubscriptionPassHint(pass, resolveSubscriptionMonthUsd());
-	const status = await fetchSubscriptionStatusForCli();
-	if (status.kind === "available") {
-		process.stderr.write(`${formatDepositGuardLine(status.facts, pass)}\n`);
-		process.stderr.write("The no-admin subscription sink cannot refund deposits. Type DEPOSIT to continue:\n");
-		const { createInterface } = await import("node:readline/promises");
-		const prompt = createInterface({
-			input: process.stdin,
-			output: process.stderr
-		});
-		let answer;
-		try {
-			answer = await prompt.question("> ");
-		} finally {
-			prompt.close();
-		}
-		process.stderr.write("\n");
-		if (!isDepositConfirmed(answer)) throw new Error("Deposit cancelled. No deposit was made.");
-		console.log(hint);
-		return;
-	}
-	process.stderr.write(`${formatDepositIrreversibilityWarning(status.reason)}\n`);
-	console.log(hint);
-}
 function addAmlAddressRiskCommand(parent, networksCommand) {
 	parent.addCommand(createCliCommand("aml-address-risk").description("CIA workflow: screen an address for AML risk, exchange behavior, and optional comparison with another address").requiredOption("--address <address>", "Full blockchain address to screen").requiredOption("--network <network>", `Network to query. Run \`${networksCommand}\` for supported networks.`).option("--compare-address <address>", "Optional second address to compare against the screened address").option("--json", "Print machine-readable JSON output").option("--version <version>", "AML tool contract version. Omit to use the latest version (currently v1)").addOption(new Option("--tool-version <version>", "Internal alias for the AML tool version").hideHelp()).action(async (opts) => {
 		try {
@@ -546,21 +486,6 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		process.exit(1);
 	}
 }));
-program.command("buy").description("Show CIA subscription pass deposit guidance (the sink cannot refund deposits)").addCommand(createCliCommand("day").description("Show day-pass deposit guidance (SUBSCRIPTION_MONTH_USD / 30)").action(async () => {
-	try {
-		await printSubscriptionPassGuidance("day");
-	} catch (err) {
-		console.error(err.message);
-		process.exit(1);
-	}
-})).addCommand(createCliCommand("month").description("Show month-pass deposit guidance at the list price").action(async () => {
-	try {
-		await printSubscriptionPassGuidance("month");
-	} catch (err) {
-		console.error(err.message);
-		process.exit(1);
-	}
-}));
 program.command("mcp").description("Low-level access to the Chain Insights MCP endpoint").allowExcessArguments(false).addCommand(createCliCommand("networks").description("List the detailed Chain Insights capability matrix and tool support").option("--json", "Print raw capability JSON").action(async (opts) => {
 	try {
 		await printNetworkCapabilities(opts);
@@ -659,7 +584,7 @@ program.command("mcp").description("Low-level access to the Chain Insights MCP e
 						json: opts.json
 					});
 				} catch (err) {
-					const { isMissingSubscriptionStatusToolError, unavailableSubscriptionStatus, subscriptionStatusText } = await import("./subscription-status-CJ-DaMW9.mjs").then((n) => n.t);
+					const { isMissingSubscriptionStatusToolError, unavailableSubscriptionStatus, subscriptionStatusText } = await import("./subscription-status-DA9DCFrC.mjs").then((n) => n.t);
 					if (!isMissingSubscriptionStatusToolError(err)) throw err;
 					const { resolveGraphMcpEndpoint } = await import("./client-gsLi528K.mjs").then((n) => n.r);
 					console.log(subscriptionStatusText(unavailableSubscriptionStatus(resolveGraphMcpEndpoint(config), `subscription_status failed: ${err.message}`)));