quota-axi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kun Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+<h1 align="center">quota-axi</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/quota-axi"><img alt="npm" src="https://img.shields.io/npm/v/quota-axi?style=flat-square" /></a>
+  <a href="https://github.com/kunchenguid/quota-axi/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/kunchenguid/quota-axi/ci.yml?style=flat-square&label=ci" /></a>
+  <a href="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue?style=flat-square"><img alt="Platform" src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue?style=flat-square" /></a>
+  <a href="https://x.com/kunchenguid"><img alt="X" src="https://img.shields.io/badge/X-@kunchenguid-black?style=flat-square" /></a>
+  <a href="https://discord.gg/Wsy2NpnZDu"><img alt="Discord" src="https://img.shields.io/discord/1439901831038763092?style=flat-square&label=discord" /></a>
+</p>
+
+<h3 align="center">Know your local agent quota headroom without turning it into routing advice.</h3>
+
+Agents need quota state before they choose where work can safely run.
+Vendor dashboards are not shaped for shell automation, and local CLIs expose different windows, resets, and auth files.
+
+quota-axi reports local Claude and Codex quota windows in one AXI-shaped call.
+It is data only: it never routes, recommends, proxies, intercepts, logs in, imports browser cookies, or mutates provider state.
+
+- **Honest comparison ceiling** - quota-axi reports normalized quota windows, reset times, and provider credit balances when available.
+- **Local first** - it reads local Claude and Codex auth sources, calls first-party provider endpoints, and can fall back to a read-only Codex app-server probe.
+- **Agent shaped** - default stdout is compact TOON, with JSON available for callers that need the normalized model.
+
+## Quick Start
+
+```sh
+$ npx -y quota-axi
+bin: ~/.npm/_npx/.../quota-axi
+description: Report local agent-provider quota windows for routing-aware agents
+generatedAt: "2026-07-06T18:10:00.000Z"
+providers[2]{provider,plan,source,status,refreshedAt}:
+  claude,pro,oauth,fresh,"2026-07-06T18:09:55.000Z"
+  codex,plus,cli-rpc,fresh,"2026-07-06T18:09:58.000Z"
+windows[6]{provider,id,label,percentRemaining,resetsAt,state}:
+  claude,five_hour,session,82,"2026-07-06T22:15:00.000Z",fresh
+  claude,seven_day,week,64,"2026-07-10T16:00:00.000Z",fresh
+  claude,seven_day_opus,opus week,93,"2026-07-11T09:30:00.000Z",fresh
+  claude,extra_usage,extra usage,75,unknown,fresh
+  codex,five_hour,session,71,"2026-07-06T21:45:00.000Z",fresh
+  codex,weekly,week,43,"2026-07-11T09:00:00.000Z",fresh
+help[3]:
+  Run `quota-axi --provider claude --json` for JSON output
+  Run `quota-axi --full` to include account and source-attempt details
+  Run `quota-axi auth` to inspect local auth source availability without printing secrets
+```
+
+```sh
+$ quota-axi auth
+bin: ~/.npm/_npx/.../quota-axi
+description: Inspect local quota auth sources without printing secret values
+auth[4]{provider,source,path,status,error}:
+  claude,oauth-file,~/.claude/.credentials.json,available,none
+  claude,keychain,none,skipped,keychain_prompt_required
+  codex,auth-json,~/.codex/auth.json,available,none
+  codex,cli-rpc,none,available,none
+help[1]:
+  Run `quota-axi --allow-keychain-prompt auth` to permit macOS Keychain access
+```
+
+## Install
+
+quota-axi requires Node.js 20 or newer.
+
+**npm**
+
+```sh
+npm install -g quota-axi
+```
+
+**Direct use**
+
+```sh
+npx -y quota-axi
+```
+
+**From source**
+
+```sh
+git clone https://github.com/kunchenguid/quota-axi.git
+cd quota-axi
+pnpm install
+pnpm run build
+pnpm run dev
+```
+
+## How It Works
+
+```
+┌────────────┐
+│ quota-axi  │
+└─────┬──────┘
+      ▼
+┌───────────────┐
+│ claude,codex  │
+└─────┬─────────┘
+      ▼
+┌───────────────┐       ┌──────────────┐
+│ local auth    │ ───▶  │ first-party  │
+│ sources       │       │ usage APIs   │
+└─────┬─────────┘       └──────┬───────┘
+      ▼                        ▼
+┌───────────────┐       ┌──────────────┐
+│ codex-only    │ ───▶  │ normalized   │
+│ CLI fallback  │       │ quota model  │
+└─────┬─────────┘       └──────┬───────┘
+      ▼                        ▼
+┌───────────────┐       ┌──────────────┐
+│ stale cache   │ ◀───  │ TOON or JSON │
+└───────────────┘       └──────────────┘
+```
+
+- **Live first** - direct provider usage calls use 15 second request timeouts, Codex JSON-RPC reads use short per-call timeouts, and stale cache fallback is per provider.
+- **No default Keychain prompt** - macOS Claude Keychain reads are skipped unless `--allow-keychain-prompt` is passed.
+- **Partial success is success** - one provider can fail while another returns fresh or stale data, and the process still exits 0. Exit code 1 means every provider failed, and 2 means a usage error.
+- **No token equivalence** - quota-axi does not claim that one provider percentage equals another provider percentage.
+
+## CLI Reference
+
+| Command     | Description                                      |
+| ----------- | ------------------------------------------------ |
+| `quota-axi` | Report Claude and Codex quota windows            |
+| `auth`      | Report local auth-source availability, no values |
+
+### Flags
+
+| Flag                      | Description                                            |
+| ------------------------- | ------------------------------------------------------ |
+| `--provider claude,codex` | Scope providers                                        |
+| `--json`                  | Emit normalized JSON instead of TOON for quota or auth |
+| `--full`                  | Include quota account identity and source attempts     |
+| `--allow-keychain-prompt` | Permit macOS Claude Keychain access that could prompt  |
+| `-h`, `--help`            | Print terse AXI help                                   |
+| `-v`, `-V`, `--version`   | Print version                                          |
+
+## Output Model
+
+`--json` emits `schemaVersion: 1`.
+Quota reports contain `providers`, each with `provider`, `label`, `source`, `windows`, `state`, optional `plan`, and optional `credits`.
+With `--full`, providers can also include `account` identity and per-source `attempts`.
+Provider `state` includes `status`, `stale`, `sourcesTried`, optional `refreshedAt`, optional `error`, and optional `retryAfter`.
+Quota windows include `id`, `label`, `kind`, optional percentages, optional reset fields, optional `windowSeconds`, and optional credit-spend fields.
+Account identity and per-source `attempts` are omitted unless `--full` is passed.
+Provider statuses are `fresh`, `stale`, `unavailable`, `auth_required`, `rate_limited`, or `error`.
+Provider sources are `oauth`, `cli-rpc`, `api`, `web`, `cache`, or `unavailable`; v1 emits `oauth`, `cli-rpc`, `cache`, and `unavailable`.
+Window kinds are `session`, `weekly`, `monthly`, `model`, `credits`, or `unknown`.
+Source attempts use `success`, `failed`, or `skipped`.
+Claude can report `five_hour`, `seven_day`, optional `seven_day_opus`, and optional `extra_usage` windows.
+When the account's usage response includes a scoped `limits` list, quota-axi surfaces every active window it describes instead, including model-scoped ones (e.g. Fable) as a `model:<slug>` window.
+Codex can report `five_hour` and `weekly` windows plus optional credit balance data, plus any additional model- or feature-scoped rate limits the account has as `model:<id>:5h` / `model:<id>:7d` windows, and an optional code-review rate limit as `code_review_five_hour` / `code_review_weekly`.
+`auth --json` emits `generatedAt`, `schemaVersion: 1`, and `auth`, where each provider report has `provider` and `sources`.
+Auth source entries include `source`, optional `path`, `status`, and optional `error`.
+Auth source statuses are `available`, `missing`, `invalid`, `expired`, or `skipped`.
+Auth source names are `oauth-file`, `keychain`, `auth-json`, and `cli-rpc`.
+
+## Security Posture
+
+quota-axi reads `~/.claude/.credentials.json` for Claude.
+On macOS, it reads `Claude Code-credentials` from Keychain only with `--allow-keychain-prompt`; when enabled, the Keychain credential is tried before file credentials.
+For Codex, it reads `$CODEX_HOME/auth.json` or `~/.codex/auth.json` before the read-only CLI fallback.
+Codex `auth.json` support is OAuth-token only; API key values such as `OPENAI_API_KEY` are treated as invalid for quota usage calls and are not sent to ChatGPT usage endpoints.
+It may run `codex -s read-only -a untrusted app-server` for Codex JSON-RPC fallback.
+It never launches the Claude CLI, so it cannot accidentally spend the quota it measures.
+
+Direct HTTP requests go only to Anthropic and OpenAI first-party usage endpoints with the user's local credentials.
+It sends credential values only to the first-party provider request they authenticate.
+It never prints, logs, or caches credential values.
+The cache lives at `~/.cache/quota-axi/quotas.json` (or under `$XDG_CACHE_HOME/quota-axi/` when `XDG_CACHE_HOME` is set), uses `0600` file permissions, and stores normalized non-secret snapshots only.
+Only fresh provider snapshots with windows are cached.
+Failed providers, stale providers, account identity, and source attempts are not cached.
+
+## Development
+
+```sh
+pnpm install       # Install dependencies
+pnpm run build    # Compile TypeScript to dist/
+pnpm test         # Run fixture parser and CLI tests
+pnpm run dev      # Run the CLI with tsx
+```
+
+## Attribution
+
+quota-axi is independently implemented from local Baby Menu quota code and public provider behavior references.
+
+## License
+
+MIT

package/dist/bin/quota-axi.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/quota-axi.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from "../src/cli.js";
+main();
+//# sourceMappingURL=quota-axi.js.map

package/dist/bin/quota-axi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-axi.js","sourceRoot":"","sources":["../../bin/quota-axi.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,IAAI,EAAE,CAAC"}

package/dist/src/cache.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderId, ProviderQuota } from "./types.js";
+export declare function readCachedProvider(provider: ProviderId): ProviderQuota | undefined;
+export declare function writeCachedProviders(providers: ProviderQuota[]): void;

package/dist/src/cache.js

@@ -0,0 +1,198 @@
+import { chmodSync, renameSync, writeFileSync } from "node:fs";
+import { cacheFilePath, ensurePrivateParent, readJsonFile } from "./lib/fs.js";
+const PROVIDER_IDS = [
+    "claude",
+    "codex",
+];
+const PROVIDER_SOURCES = [
+    "oauth",
+    "cli-rpc",
+    "api",
+    "web",
+    "cache",
+    "unavailable",
+];
+const PROVIDER_STATUSES = [
+    "fresh",
+    "stale",
+    "unavailable",
+    "auth_required",
+    "rate_limited",
+    "error",
+];
+const WINDOW_KINDS = [
+    "session",
+    "weekly",
+    "monthly",
+    "model",
+    "credits",
+    "unknown",
+];
+export function readCachedProvider(provider) {
+    return readCacheProviders().find((item) => item.provider === provider);
+}
+export function writeCachedProviders(providers) {
+    const cacheable = providers
+        .map(toCacheProvider)
+        .filter((provider) => Boolean(provider));
+    if (cacheable.length === 0)
+        return;
+    const file = cacheFilePath();
+    const byProvider = new Map();
+    for (const provider of readCacheProviders())
+        byProvider.set(provider.provider, provider);
+    for (const provider of cacheable)
+        byProvider.set(provider.provider, provider);
+    const merged = PROVIDER_IDS.map((provider) => byProvider.get(provider)).filter((provider) => Boolean(provider));
+    ensurePrivateParent(file);
+    const temp = `${file}.${process.pid}.tmp`;
+    writeFileSync(temp, `${JSON.stringify({ generatedAt: new Date().toISOString(), schemaVersion: 1, providers: merged }, null, 2)}\n`, { mode: 0o600 });
+    chmodSync(temp, 0o600);
+    renameSync(temp, file);
+    chmodSync(file, 0o600);
+}
+function readCacheProviders() {
+    const raw = readJsonFile(cacheFilePath());
+    const payload = objectValue(raw);
+    if (!payload ||
+        payload.schemaVersion !== 1 ||
+        !Array.isArray(payload.providers))
+        return [];
+    return payload.providers
+        .map(normalizeCachedProvider)
+        .filter((provider) => Boolean(provider));
+}
+function toCacheProvider(provider) {
+    if (provider.state.status !== "fresh" || provider.windows.length === 0)
+        return undefined;
+    return normalizeCachedProvider({
+        provider: provider.provider,
+        label: provider.label,
+        source: provider.source,
+        plan: provider.plan,
+        windows: provider.windows,
+        credits: provider.credits,
+        state: {
+            status: provider.state.status,
+            stale: false,
+            refreshedAt: provider.state.refreshedAt,
+            sourcesTried: provider.state.sourcesTried,
+        },
+    });
+}
+function normalizeCachedProvider(raw) {
+    const data = objectValue(raw);
+    if (!data)
+        return undefined;
+    const provider = literalValue(data.provider, PROVIDER_IDS);
+    const label = stringValue(data.label);
+    const source = literalValue(data.source, PROVIDER_SOURCES);
+    const state = objectValue(data.state);
+    const status = literalValue(state?.status, PROVIDER_STATUSES);
+    const sourcesTried = stringArrayValue(state?.sourcesTried);
+    const windows = Array.isArray(data.windows)
+        ? data.windows
+            .map(normalizeCachedWindow)
+            .filter((window) => Boolean(window))
+        : [];
+    if (!provider ||
+        !label ||
+        !source ||
+        !state ||
+        !status ||
+        !sourcesTried ||
+        windows.length === 0)
+        return undefined;
+    const result = {
+        provider,
+        label,
+        source,
+        windows,
+        state: {
+            status,
+            stale: booleanValue(state.stale) ?? false,
+            sourcesTried,
+        },
+    };
+    const plan = stringValue(data.plan);
+    const refreshedAt = stringValue(state.refreshedAt);
+    const credits = normalizeCachedCredits(data.credits);
+    if (plan)
+        result.plan = plan;
+    if (refreshedAt)
+        result.state.refreshedAt = refreshedAt;
+    if (credits)
+        result.credits = credits;
+    return result;
+}
+function normalizeCachedWindow(raw) {
+    const data = objectValue(raw);
+    if (!data)
+        return undefined;
+    const id = stringValue(data.id);
+    const label = stringValue(data.label);
+    const kind = literalValue(data.kind, WINDOW_KINDS);
+    if (!id || !label || !kind)
+        return undefined;
+    const result = { id, label, kind };
+    assignNumber(result, "percentUsed", data.percentUsed);
+    assignNumber(result, "percentRemaining", data.percentRemaining);
+    assignString(result, "resetsAt", data.resetsAt);
+    assignString(result, "resetText", data.resetText);
+    assignNumber(result, "windowSeconds", data.windowSeconds);
+    assignNumber(result, "spentUsd", data.spentUsd);
+    assignNumber(result, "limitUsd", data.limitUsd);
+    return result;
+}
+function normalizeCachedCredits(raw) {
+    const data = objectValue(raw);
+    if (!data)
+        return undefined;
+    const remaining = numberValue(data.remaining);
+    const unlimited = booleanValue(data.unlimited);
+    const unit = literalValue(data.unit, ["usd", "credits"]);
+    if (remaining === undefined && unlimited === undefined && unit === undefined)
+        return undefined;
+    return {
+        remaining,
+        unlimited,
+        unit,
+    };
+}
+function assignNumber(target, key, value) {
+    const number = numberValue(value);
+    if (number !== undefined)
+        target[key] = number;
+}
+function assignString(target, key, value) {
+    const string = stringValue(value);
+    if (string !== undefined)
+        target[key] = string;
+}
+function objectValue(value) {
+    return value && typeof value === "object"
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+function booleanValue(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+function stringArrayValue(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string")
+        ? value
+        : undefined;
+}
+function literalValue(value, values) {
+    return typeof value === "string" && values.includes(value)
+        ? value
+        : undefined;
+}
+//# sourceMappingURL=cache.js.map

package/dist/src/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/src/cli.d.ts

@@ -0,0 +1,18 @@
+import type { ProviderId } from "./types.js";
+export declare const DESCRIPTION = "Report local agent-provider quota windows for routing-aware agents.";
+export declare const TOP_HELP = "usage: quota-axi [auth] [flags]\ncommands[2]:\n  (none)=quota, auth\nflags[6]:\n  --provider <claude,codex>, --json, --full, --allow-keychain-prompt, --help, -v/--version\nexamples:\n  quota-axi\n  quota-axi --provider claude\n  quota-axi --json\n  quota-axi --full\n  quota-axi auth\n";
+type MainOptions = {
+    argv?: string[];
+    stdout?: Pick<NodeJS.WriteStream, "write">;
+    binPath?: string;
+};
+type ParsedArgs = {
+    command: "quota" | "auth" | "help" | "version";
+    providers: ProviderId[];
+    json: boolean;
+    full: boolean;
+    allowKeychainPrompt: boolean;
+};
+export declare function main(options?: MainOptions): Promise<void>;
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export {};

package/dist/src/cli.js

@@ -0,0 +1,152 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { writeCachedProviders } from "./cache.js";
+import { nowIso } from "./lib/time.js";
+import { PROVIDERS, parseProviders } from "./providers/index.js";
+import { redactedResponse, renderAuthToon, renderError, renderQuotaToon, } from "./render.js";
+export const DESCRIPTION = "Report local agent-provider quota windows for routing-aware agents.";
+export const TOP_HELP = `usage: quota-axi [auth] [flags]
+commands[2]:
+  (none)=quota, auth
+flags[6]:
+  --provider <claude,codex>, --json, --full, --allow-keychain-prompt, --help, -v/--version
+examples:
+  quota-axi
+  quota-axi --provider claude
+  quota-axi --json
+  quota-axi --full
+  quota-axi auth
+`;
+export async function main(options = {}) {
+    const stdout = options.stdout ?? process.stdout;
+    const binPath = options.binPath ?? process.argv[1] ?? "quota-axi";
+    try {
+        const parsed = parseArgs(options.argv ?? process.argv.slice(2));
+        if (parsed.command === "help") {
+            stdout.write(TOP_HELP);
+            return;
+        }
+        if (parsed.command === "version") {
+            stdout.write(`quota-axi ${readPackageVersion()}\n`);
+            return;
+        }
+        const providerOptions = {
+            allowKeychainPrompt: parsed.allowKeychainPrompt,
+        };
+        if (parsed.command === "auth") {
+            const reports = await inspectAuth(parsed.providers, providerOptions);
+            if (parsed.json) {
+                stdout.write(`${JSON.stringify({ generatedAt: nowIso(), schemaVersion: 1, auth: reports }, null, 2)}\n`);
+            }
+            else {
+                stdout.write(`${renderAuthToon(reports, binPath)}\n`);
+            }
+            return;
+        }
+        const response = await fetchQuota(parsed.providers, providerOptions);
+        const rendered = parsed.json
+            ? JSON.stringify(redactedResponse(response, parsed.full), null, 2)
+            : renderQuotaToon(redactedResponse(response, parsed.full), binPath, parsed.full);
+        stdout.write(`${rendered}\n`);
+        if (response.providers.every((provider) => isFailed(provider))) {
+            process.exitCode = 1;
+        }
+        writeCachedProvidersBestEffort(response.providers);
+    }
+    catch (error) {
+        stdout.write(`${renderError(error instanceof Error ? error.message : "quota-axi failed", "usage", ["Run `quota-axi --help` for supported commands and flags"])}\n`);
+        process.exitCode = 2;
+    }
+}
+export function parseArgs(argv) {
+    let command = "quota";
+    let providerValue;
+    let json = false;
+    let full = false;
+    let allowKeychainPrompt = false;
+    for (let index = 0; index < argv.length; index++) {
+        const arg = argv[index];
+        if (arg === "auth") {
+            command = "auth";
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            command = "help";
+            continue;
+        }
+        if (arg === "--version" || arg === "-v" || arg === "-V") {
+            command = "version";
+            continue;
+        }
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--full") {
+            full = true;
+            continue;
+        }
+        if (arg === "--allow-keychain-prompt") {
+            allowKeychainPrompt = true;
+            continue;
+        }
+        if (arg === "--provider") {
+            const value = argv[index + 1];
+            if (!value)
+                throw new Error("--provider requires a comma-separated provider list");
+            providerValue = value;
+            index++;
+            continue;
+        }
+        if (arg.startsWith("--provider=")) {
+            providerValue = arg.slice("--provider=".length);
+            continue;
+        }
+        throw new Error(`unknown argument: ${arg}`);
+    }
+    return {
+        command,
+        providers: parseProviders(providerValue),
+        json,
+        full,
+        allowKeychainPrompt,
+    };
+}
+async function fetchQuota(providers, options) {
+    const results = await Promise.all(providers.map((provider) => PROVIDERS[provider].fetchQuota(options)));
+    return {
+        generatedAt: nowIso(),
+        schemaVersion: 1,
+        providers: results,
+    };
+}
+async function inspectAuth(providers, options) {
+    return Promise.all(providers.map((provider) => PROVIDERS[provider].inspectAuth(options)));
+}
+function isFailed(provider) {
+    return !["fresh", "stale"].includes(provider.state.status);
+}
+function writeCachedProvidersBestEffort(providers) {
+    try {
+        writeCachedProviders(providers);
+    }
+    catch {
+        return;
+    }
+}
+function readPackageVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    for (const candidate of [
+        join(here, "..", "package.json"),
+        join(here, "..", "..", "package.json"),
+    ]) {
+        if (!existsSync(candidate))
+            continue;
+        const parsed = JSON.parse(readFileSync(candidate, "utf-8"));
+        if (typeof parsed.version === "string" && parsed.version.length > 0)
+            return parsed.version;
+    }
+    return "0.0.0";
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/fs.d.ts

@@ -0,0 +1,14 @@
+export type JsonFileReadResult = {
+    status: "success";
+    value: unknown;
+} | {
+    status: "missing";
+} | {
+    status: "invalid";
+    error: string;
+};
+export declare function collapseHome(path: string): string;
+export declare function cacheFilePath(): string;
+export declare function ensurePrivateParent(file: string): void;
+export declare function readJsonFile(file: string): unknown | undefined;
+export declare function readJsonFileResult(file: string): JsonFileReadResult;