shadowjoin 0.0.0-stage → 0.3.0

package/dist/ui.js

@@ -0,0 +1,80 @@
+/**
+ * Terminal presentation. Everything here is silent unless stdout is a TTY, so
+ * piping to a file, to jq, or running in CI produces exactly the same bytes it
+ * always did.
+ */
+const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const DIM = "\x1b[2m", RESET = "\x1b[0m", BOLD = "\x1b[1m";
+const BLUE = "\x1b[38;5;75m", GREY = "\x1b[38;5;244m", AMBER = "\x1b[38;5;214m";
+export const isTty = () => Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+export function banner(version) {
+    if (!isTty())
+        return "";
+    return [
+        "",
+        `  ${BLUE}▌${RESET}${BOLD} shadowjoin ${RESET}${GREY}v${version}${RESET}`,
+        `  ${BLUE}▌${RESET}${DIM} the matches your join never told you it was losing${RESET}`,
+        "",
+    ].join("\n");
+}
+export function footer(version) {
+    if (!isTty())
+        return "";
+    return `  ${GREY}shadowjoin v${version}  ·  MIT  ·  Harsh N. Chandak  ·  harsh-chandak.com${RESET}\n`;
+}
+/** A spinner that degrades to nothing when it isn't being watched by a human. */
+export class Progress {
+    timer = null;
+    frame = 0;
+    label = "";
+    started = Date.now();
+    done = [];
+    start(label) {
+        this.label = label;
+        if (!isTty())
+            return;
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.paint(), 80);
+        this.timer.unref?.();
+        this.paint();
+    }
+    /** Mark the current step finished and begin the next one. */
+    step(label) {
+        if (isTty()) {
+            this.clear();
+            process.stdout.write(`  ${BLUE}✓${RESET} ${DIM}${this.label}${RESET}\n`);
+        }
+        this.done.push(this.label);
+        this.label = label;
+        if (isTty())
+            this.paint();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (!isTty())
+            return;
+        this.clear();
+        const ms = Date.now() - this.started;
+        process.stdout.write(`  ${BLUE}✓${RESET} ${DIM}${this.label}${RESET}  ${GREY}${ms}ms${RESET}\n`);
+    }
+    /** Clear the spinner without claiming the step succeeded. */
+    abort() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (isTty())
+            this.clear();
+    }
+    clear() {
+        process.stdout.write("\r\x1b[2K");
+    }
+    paint() {
+        const f = FRAMES[this.frame++ % FRAMES.length];
+        process.stdout.write(`\r\x1b[2K  ${AMBER}${f}${RESET} ${this.label}`);
+    }
+}

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "shadowjoin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Measure the matches your exact join is silently dropping. Runs a shadow matcher alongside your real join key and reports a verified floor on lost matches, plus the normalization rule that would recover each one.",
+  "keywords": [
+    "entity-resolution",
+    "record-linkage",
+    "data-quality",
+    "fuzzy-matching",
+    "deduplication",
+    "pair-completeness",
+    "join",
+    "postgres",
+    "csv",
+    "mcp",
+    "data-validation",
+    "recall",
+    "mysql",
+    "sqlite"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "shadowjoin": "dist/cli.js",
+    "shadowjoin-mcp": "dist/mcp.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./mcp": "./dist/mcp.js",
+    "./adapters/postgres": "./dist/adapters/postgres.js",
+    "./adapters/mysql": "./dist/adapters/mysql.js",
+    "./adapters/sqlite": "./dist/adapters/sqlite.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SKILL.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test test/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": ">=1",
+    "mysql2": ">=3",
+    "pg": ">=8"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.23.1",
+    "mysql2": "^3.24.5",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harsh-chandak/shadowjoin.git"
+  },
+  "homepage": "https://github.com/harsh-chandak/shadowjoin#readme",
+  "author": "Harsh N. Chandak",
+  "bugs": {
+    "url": "https://github.com/harsh-chandak/shadowjoin/issues"
+  },
+  "mcpName": "io.github.harsh-chandak/shadowjoin"
+}