@warmdrift/kgauto-check 0.1.0 → 0.1.1

package/README.md

@@ -2,12 +2,30 @@
 
 **Point your AI at your project.**
 
-If you're the human: copy the block below to your coding agent (Claude Code, Cursor, or any MCP-capable agent). That's your whole job.
+If you're the human and your agent can browse + run commands, one sentence is enough:
 
 ```
-Add the kgauto check MCP server and run the check on this project:
-  claude mcp add kgauto-check -- npx -y @warmdrift/kgauto-check
-Then call its start_check tool and follow the instructions.
+Run the kgauto check on this project. Instructions for you, the agent: fetch https://model-check-alpha.vercel.app/check.html and follow its "For the agent" section. Show me the card it produces, verbatim.
+```
+
+Or the manual version — your part is two steps.
+
+**Step 1 — add the check to your agent (once).** Claude Code: run this in a terminal, then start a fresh session in your project (new MCP servers load at session start):
+
+```bash
+claude mcp add kgauto-check -- npx -y @warmdrift/kgauto-check
+```
+
+Cursor and most other agents — add to your MCP config, then restart the app:
+
+```json
+{ "mcpServers": { "kgauto-check": { "command": "npx", "args": ["-y", "@warmdrift/kgauto-check"] } } }
+```
+
+**Step 2 — paste the ask**, in your agent, inside the project you want checked:
+
+```
+Run the kgauto check on this project: call kgauto-check's start_check tool, follow its instructions, and show me the card it returns, verbatim.
 ```
 
 Everything below is for the agent.
@@ -20,6 +38,16 @@ A local, **fully offline** MCP server that checks a project's AI call surface ag
 
 **The trust boundary:** you read the project's code (you already have access); kgauto reads nothing. The extract you build carries identifiers and counts only — never prompt text, source code, or secrets. This check ran locally against kgauto's bundled model catalog. Nothing is uploaded; no rows are written anywhere. There is no code path that could make that sentence false: the server makes no network calls.
 
+## Zero-install one-shot (shell-capable agents)
+
+No MCP setup, no restart:
+
+```bash
+npx -y @warmdrift/kgauto-check --extract-contract   # extraction instructions + privacy contract
+# ...read the project, write extract.json per those instructions...
+npx -y @warmdrift/kgauto-check --extract extract.json   # prints the findings card, fully offline
+```
+
 ## Tools
 
 | Tool | What it does |

package/dist/bin.js

@@ -1,10 +1,50 @@
 #!/usr/bin/env node
 import {
+  ExtractSchema,
+  START_CHECK_INSTRUCTIONS,
+  runCheck,
   startStdio
-} from "./chunk-WJEKN4BL.js";
+} from "./chunk-2DPBQQWM.js";
 
 // src/bin.ts
-startStdio().catch((err) => {
-  console.error("kgauto-check-mcp failed to start:", err);
-  process.exit(1);
-});
+import { readFileSync } from "fs";
+var args = process.argv.slice(2);
+function oneShot() {
+  if (args.includes("--extract-contract")) {
+    console.log(START_CHECK_INSTRUCTIONS);
+    return true;
+  }
+  const i = args.indexOf("--extract");
+  if (i === -1) return false;
+  const file = args[i + 1];
+  if (!file) {
+    console.error("usage: kgauto-check-mcp --extract <extract.json>   (or --extract-contract for instructions)");
+    process.exitCode = 1;
+    return true;
+  }
+  let raw;
+  try {
+    raw = JSON.parse(readFileSync(file, "utf8"));
+  } catch (err) {
+    console.error(`could not read ${file}: ${err instanceof Error ? err.message : String(err)}`);
+    process.exitCode = 1;
+    return true;
+  }
+  const parsed = ExtractSchema.safeParse(raw);
+  if (!parsed.success) {
+    console.error("extract does not match the contract (run --extract-contract for the spec):");
+    for (const issue of parsed.error.issues.slice(0, 10)) {
+      console.error(`  - ${issue.path.join(".")}: ${issue.message}`);
+    }
+    process.exitCode = 1;
+    return true;
+  }
+  console.log(runCheck(parsed.data).card);
+  return true;
+}
+if (!oneShot()) {
+  startStdio().catch((err) => {
+    console.error("kgauto-check-mcp failed to start:", err);
+    process.exit(1);
+  });
+}

package/dist/{chunk-WJEKN4BL.js → chunk-2DPBQQWM.js}

@@ -352,7 +352,17 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z as z2 } from "zod";
 import { tryGetProfile as tryGetProfile2, resolveModelAlias as resolveModelAlias2, LIBRARY_VERSION as LIBRARY_VERSION2 } from "@warmdrift/kgauto-compiler";
-var CHECK_VERSION = "0.1.0";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+var CHECK_VERSION = (() => {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return JSON.parse(readFileSync(join(here, "../package.json"), "utf8")).version;
+  } catch {
+    return "0.0.0-unknown";
+  }
+})();
 var text = (t) => ({ content: [{ type: "text", text: t }] });
 function buildServer() {
   const server = new McpServer(

package/dist/index.d.ts

@@ -55,7 +55,7 @@ declare const CallSiteSchema: z.ZodObject<{
     usesParallelToolCalls?: boolean | undefined;
     expectsStructuredOutput?: boolean | undefined;
     streaming?: boolean | undefined;
-    retry?: "none" | "same-model" | "fallback-chain" | "unknown" | undefined;
+    retry?: "unknown" | "none" | "same-model" | "fallback-chain" | undefined;
     fallbackModels?: string[] | undefined;
     estCallsPerMonth?: number | undefined;
     notes?: string | undefined;
@@ -71,7 +71,7 @@ declare const CallSiteSchema: z.ZodObject<{
     usesParallelToolCalls?: boolean | undefined;
     expectsStructuredOutput?: boolean | undefined;
     streaming?: boolean | undefined;
-    retry?: "none" | "same-model" | "fallback-chain" | "unknown" | undefined;
+    retry?: "unknown" | "none" | "same-model" | "fallback-chain" | undefined;
     fallbackModels?: string[] | undefined;
     estCallsPerMonth?: number | undefined;
     notes?: string | undefined;
@@ -133,7 +133,7 @@ declare const ExtractSchema: z.ZodObject<{
         usesParallelToolCalls?: boolean | undefined;
         expectsStructuredOutput?: boolean | undefined;
         streaming?: boolean | undefined;
-        retry?: "none" | "same-model" | "fallback-chain" | "unknown" | undefined;
+        retry?: "unknown" | "none" | "same-model" | "fallback-chain" | undefined;
         fallbackModels?: string[] | undefined;
         estCallsPerMonth?: number | undefined;
         notes?: string | undefined;
@@ -149,7 +149,7 @@ declare const ExtractSchema: z.ZodObject<{
         usesParallelToolCalls?: boolean | undefined;
         expectsStructuredOutput?: boolean | undefined;
         streaming?: boolean | undefined;
-        retry?: "none" | "same-model" | "fallback-chain" | "unknown" | undefined;
+        retry?: "unknown" | "none" | "same-model" | "fallback-chain" | undefined;
         fallbackModels?: string[] | undefined;
         estCallsPerMonth?: number | undefined;
         notes?: string | undefined;
@@ -172,7 +172,7 @@ declare const ExtractSchema: z.ZodObject<{
         usesParallelToolCalls?: boolean | undefined;
         expectsStructuredOutput?: boolean | undefined;
         streaming?: boolean | undefined;
-        retry?: "none" | "same-model" | "fallback-chain" | "unknown" | undefined;
+        retry?: "unknown" | "none" | "same-model" | "fallback-chain" | undefined;
         fallbackModels?: string[] | undefined;
         estCallsPerMonth?: number | undefined;
         notes?: string | undefined;
@@ -195,7 +195,7 @@ declare const ExtractSchema: z.ZodObject<{
         usesParallelToolCalls?: boolean | undefined;
         expectsStructuredOutput?: boolean | undefined;
         streaming?: boolean | undefined;
-        retry?: "none" | "same-model" | "fallback-chain" | "unknown" | undefined;
+        retry?: "unknown" | "none" | "same-model" | "fallback-chain" | undefined;
         fallbackModels?: string[] | undefined;
         estCallsPerMonth?: number | undefined;
         notes?: string | undefined;

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   buildServer,
   renderCard,
   runCheck
-} from "./chunk-WJEKN4BL.js";
+} from "./chunk-2DPBQQWM.js";
 export {
   CallSiteSchema,
   DESTINATION_SENTENCE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-check",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Point your AI at your project — kgauto's local MCP check. Your coding agent extracts your AI surface (identifiers and counts, never code) and this server checks it against kgauto's verified model catalog: statuses, prices, cliffs, capability mismatches, resilience. Runs fully offline; nothing is uploaded, no rows are written anywhere.",
   "type": "module",
   "bin": {