vibedate 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+import { Harness, UsageSnapshot } from '@pooriaarab/vibe-core';
+export { Harness, UsageSnapshot, createConsentLedger } from '@pooriaarab/vibe-core';
+
+/**
+ * vibedating — dating by token usage.
+ *
+ * v0 library surface: league bucketing, local usage reading, and in-league
+ * matching against a seeded set of candidate profiles. Raw usage never leaves
+ * the machine; only the league bucket is shared.
+ *
+ * Builds on `@pooriaarab/vibe-core` (UsageSnapshot / Harness / consent ledger).
+ */
+
+/**
+ * A usage league (volume bucket). `max` is inclusive; the top tier is open-ended
+ * (Number.POSITIVE_INFINITY).
+ */
+interface League {
+    readonly name: string;
+    readonly min: number;
+    readonly max: number;
+}
+/**
+ * The five real leagues, in ascending order. (Accounts below 1M are reported as
+ * {@link BELOW_LEAGUE} — not a real league, but adjacent to the 1M tier.)
+ */
+declare const LEAGUES: readonly League[];
+/** League name for accounts that haven't crossed the first threshold yet. */
+declare const BELOW_LEAGUE = "below-1M";
+/**
+ * Bucket a lifetime token count into a league. Pure: same input → same output.
+ *
+ * Returns `{ name, min }`. For counts below 1M the name is {@link BELOW_LEAGUE}
+ * with `min: 0`. Non-negative only; negatives are clamped to 0. Non-integers are
+ * floored (so 999_999.9 → below-1M, 1_000_000.9 → 1M).
+ */
+declare function league(totalTokens: number): {
+    name: string;
+    min: number;
+};
+/** Index of a league name in {@link LEAGUES}; {@link BELOW_LEAGUE} → -1. */
+declare function leagueIndex(name: string): number;
+/** Env var that holds a self-reported total token count (e.g. `23400000`). */
+declare const TOKENS_ENV = "VIBEDATING_TOKENS";
+/**
+ * Demo total used when there is no real read and no env value, so `connect` and
+ * the local web app work out of the box. Lands in the 10M league.
+ */
+declare const DEMO_TOTAL_TOKENS = 23400000;
+/**
+ * v0 usage reader. Resolution order:
+ *
+ *   1. (future) read-only OAuth → `verified: true`. **NOT implemented in v0** —
+ *      see {@link tryReadVerifiedUsage}. This arm is the deliberate seam.
+ *   2. a self-reported value from the {@link TOKENS_ENV} env var → `verified: false`.
+ *   3. the demo value {@link DEMO_TOTAL_TOKENS} → `verified: false`.
+ *
+ * The snapshot's `totalTokens` is the only thing that must never leave the
+ * machine; everything downstream consumes only the league bucket.
+ */
+declare function readUsage(harness?: Harness): Promise<UsageSnapshot>;
+/**
+ * Future home of read-only OAuth verification. Returns `null` in v0.
+ *
+ * Implementing this (reading a real, provider-attested usage scope) flips the
+ * snapshot to `verified: true` and is what makes the league trustworthy. Kept as
+ * an explicit, named seam rather than a TODO comment so the privacy contract is
+ * visible at the call site.
+ */
+declare function tryReadVerifiedUsage(_harness: Harness): Promise<UsageSnapshot | null>;
+/**
+ * Parse a self-reported token count: a plain integer (`23400000`), or a suffixed
+ * value (`12M`, `1.2B`, `500k`, `500K`). Returns `undefined` for anything that is
+ * not a non-negative finite number, so callers can fall through to a default.
+ */
+declare function parseTokensEnv(raw: string | undefined): number | undefined;
+/** A seeded candidate profile for the local demo (no real directory in v0). */
+interface Candidate {
+    readonly handle: string;
+    readonly league: string;
+    readonly bio: readonly string[];
+}
+/**
+ * Seeded demo pool. In v0 there is no central directory — these profiles live
+ * locally only. Handles are abstract (no real identities); bios are flavor.
+ */
+declare const CANDIDATES: readonly Candidate[];
+/**
+ * Filter `candidates` to the same league as `myLeague` or an adjacent one.
+ *
+ * "Adjacent" = exactly one tier above or below in {@link LEAGUES}, which keeps
+ * the top of the ladder (1B+) from being an empty pool and lets newcomers
+ * (below-1M) still see the 1M tier. Unknown league names never match. Pure and
+ * order-preserving.
+ */
+declare function matches(myLeague: string, candidates?: readonly Candidate[]): Candidate[];
+
+export { BELOW_LEAGUE, CANDIDATES, type Candidate, DEMO_TOTAL_TOKENS, LEAGUES, type League, TOKENS_ENV, league, leagueIndex, matches, parseTokensEnv, readUsage, tryReadVerifiedUsage };

package/dist/index.js

@@ -0,0 +1,28 @@
+import {
+  BELOW_LEAGUE,
+  CANDIDATES,
+  DEMO_TOTAL_TOKENS,
+  LEAGUES,
+  TOKENS_ENV,
+  createConsentLedger,
+  league,
+  leagueIndex,
+  matches,
+  parseTokensEnv,
+  readUsage,
+  tryReadVerifiedUsage
+} from "./chunk-AU7FN2LY.js";
+export {
+  BELOW_LEAGUE,
+  CANDIDATES,
+  DEMO_TOTAL_TOKENS,
+  LEAGUES,
+  TOKENS_ENV,
+  createConsentLedger,
+  league,
+  leagueIndex,
+  matches,
+  parseTokensEnv,
+  readUsage,
+  tryReadVerifiedUsage
+};

package/dist/mcp.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Start the stdio MCP server. Resolves once connected to the transport; the
+ * transport then keeps the process alive for the host agent to call tools.
+ */
+declare function runMcp(): Promise<void>;
+
+export { runMcp };

package/dist/mcp.js

@@ -0,0 +1,7 @@
+import {
+  runMcp
+} from "./chunk-64ME4THO.js";
+import "./chunk-AU7FN2LY.js";
+export {
+  runMcp
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "vibedate",
+  "version": "0.1.0",
+  "description": "Dating by tokens — matched by usage league across agentic CLIs. Raw usage stays local; only your league is shared. CLI + local web app + MCP. Local-first.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Pooria Arab",
+  "bin": {
+    "vibedating": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/cli.ts src/mcp.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@pooriaarab/vibe-core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "homepage": "https://github.com/pooriaarab/vibedating#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pooriaarab/vibedating.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pooriaarab/vibedating/issues"
+  },
+  "keywords": [
+    "vibe-suite",
+    "vibedating",
+    "claude-code",
+    "codex",
+    "agentic",
+    "cli",
+    "mcp",
+    "tokens",
+    "local-first"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}