@notjustyou/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Not Just You
+
+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,37 @@
+# @notjustyou/cli
+
+Read-only command line status lookup for Not Just You AI service surfaces.
+
+## Install
+
+```bash
+npm install -g @notjustyou/cli
+```
+
+You can also run it from a workspace checkout:
+
+```bash
+pnpm --filter @notjustyou/cli build
+node packages/notjustyou-cli/dist/index.js status --base-url http://localhost:3000
+```
+
+## Usage
+
+```bash
+njy status
+njy status openai-api
+njy status openai-api --watch
+njy status --base-url http://localhost:3000
+```
+
+The CLI reads public status summaries only:
+
+- `/api/summary`
+- `/api/signals/summary`
+- `/api/official`
+
+It does not submit reports or installed-client signals, and it does not require collector credentials.
+
+## Privacy Boundary
+
+The CLI does not collect prompt text, request or response bodies, headers, API keys, cookies, source files, diffs, clipboard content, exact IP addresses, account emails, or machine/user names.

package/dist/api.d.ts

@@ -0,0 +1,3 @@
+import type { StatusData } from "./types.js";
+export declare function fetchStatusData(baseUrl: string): Promise<StatusData>;
+export declare function normalizeBaseUrl(baseUrl: string): string;

package/dist/api.js

@@ -0,0 +1,30 @@
+export async function fetchStatusData(baseUrl) {
+    const normalizedBaseUrl = normalizeBaseUrl(baseUrl);
+    const [communityResult, installedSignalsResult, officialResult] = await Promise.allSettled([
+        fetchJson(`${normalizedBaseUrl}/api/summary`),
+        fetchJson(`${normalizedBaseUrl}/api/signals/summary`),
+        fetchJson(`${normalizedBaseUrl}/api/official`),
+    ]);
+    if (communityResult.status === "rejected") {
+        throw communityResult.reason;
+    }
+    return {
+        community: communityResult.value,
+        installedSignals: installedSignalsResult.status === "fulfilled"
+            ? installedSignalsResult.value
+            : null,
+        official: officialResult.status === "fulfilled" ? officialResult.value : null,
+    };
+}
+export function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, "");
+}
+async function fetchJson(url) {
+    const response = await fetch(url, {
+        cache: "no-store",
+    });
+    if (!response.ok) {
+        throw new Error(`Request failed: ${url} (${response.status})`);
+    }
+    return (await response.json());
+}

package/dist/format.d.ts

@@ -0,0 +1,2 @@
+import type { StatusData } from "./types.js";
+export declare function formatStatus(data: StatusData, serviceId?: string): string;

package/dist/format.js

@@ -0,0 +1,49 @@
+export function formatStatus(data, serviceId) {
+    const serviceIds = getServiceIds(data, serviceId);
+    if (serviceId && serviceIds.length === 0) {
+        return `No status found for ${serviceId}.`;
+    }
+    return serviceIds
+        .map((id) => formatServiceStatus({
+        serviceId: id,
+        community: data.community.services.find((service) => service.serviceId === id),
+        installedSignals: data.installedSignals?.services.find((service) => service.serviceId === id),
+        official: data.official?.services.find((service) => service.serviceId === id),
+        installedSignalsAvailable: Boolean(data.installedSignals),
+    }))
+        .join("\n\n");
+}
+function getServiceIds(data, serviceId) {
+    if (serviceId) {
+        const exists = data.community.services.some((service) => service.serviceId === serviceId) ||
+            data.installedSignals?.services.some((service) => service.serviceId === serviceId) ||
+            Boolean(data.official?.services.some((service) => service.serviceId === serviceId));
+        return exists ? [serviceId] : [];
+    }
+    return data.community.services.map((service) => service.serviceId);
+}
+function formatServiceStatus(input) {
+    const communityTotal = input.community?.total ?? 0;
+    const installedTotal = input.installedSignals?.total ?? 0;
+    const officialText = input.official
+        ? `${formatValue(input.official.overall)} (${input.official.source})`
+        : "unavailable";
+    const lines = [
+        input.serviceId,
+        `Community reports: ${communityTotal}`,
+        input.installedSignalsAvailable
+            ? `Installed signals: ${installedTotal}`
+            : "Installed signals: unavailable",
+        input.installedSignalsAvailable
+            ? `Unique installations: ${input.installedSignals?.uniqueInstallationsApprox ?? 0}`
+            : "Unique installations: unavailable",
+        `Official: ${officialText}`,
+    ];
+    if (input.installedSignals?.lastSignal) {
+        lines.push(`Last installed signal: ${formatValue(input.installedSignals.lastSignal.symptom)}`);
+    }
+    return lines.join("\n");
+}
+function formatValue(value) {
+    return value.replaceAll("_", " ");
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<0 | 1>;
+export declare function parseCliArgs(argv: string[]): {
+    command: string;
+    serviceId: string;
+    watch: boolean;
+    baseUrl: string;
+};
+export declare function isDirectRun(metaUrl: string, argvPath?: string): boolean;

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { parseArgs } from "node:util";
+import { setTimeout as delay } from "node:timers/promises";
+import { fileURLToPath } from "node:url";
+import { fetchStatusData } from "./api.js";
+import { formatStatus } from "./format.js";
+const DEFAULT_BASE_URL = "https://notjustyou.dev";
+const WATCH_INTERVAL_MS = 2_000;
+export async function main(argv = process.argv.slice(2)) {
+    const parsed = parseCliArgs(argv);
+    if (parsed.command !== "status") {
+        printUsage();
+        return parsed.command === "help" ? 0 : 1;
+    }
+    await runStatus({
+        baseUrl: parsed.baseUrl,
+        serviceId: parsed.serviceId,
+        watch: parsed.watch,
+    });
+    return 0;
+}
+export function parseCliArgs(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            "base-url": {
+                type: "string",
+            },
+            watch: {
+                type: "boolean",
+                default: false,
+            },
+            help: {
+                type: "boolean",
+                short: "h",
+                default: false,
+            },
+        },
+    });
+    const [command = "", serviceId] = positionals;
+    return {
+        command: values.help ? "help" : command,
+        serviceId,
+        watch: values.watch ?? false,
+        baseUrl: values["base-url"] ?? process.env.NOTJUSTYOU_BASE_URL ?? DEFAULT_BASE_URL,
+    };
+}
+async function runStatus(input) {
+    let keepRunning = true;
+    process.once("SIGINT", () => {
+        keepRunning = false;
+    });
+    do {
+        const data = await fetchStatusData(input.baseUrl);
+        const output = formatStatus(data, input.serviceId);
+        console.log(output);
+        if (!input.watch)
+            return;
+        await delay(WATCH_INTERVAL_MS);
+        if (keepRunning) {
+            console.log("");
+        }
+    } while (keepRunning);
+}
+function printUsage() {
+    console.log(`Usage:
+  njy status [serviceId] [--base-url <url>] [--watch]
+
+Examples:
+  njy status
+  njy status openai-api --base-url http://localhost:3000
+  njy status openai-api --watch`);
+}
+export function isDirectRun(metaUrl, argvPath = process.argv[1]) {
+    if (!argvPath)
+        return false;
+    try {
+        return realpathSync(argvPath) === realpathSync(fileURLToPath(metaUrl));
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectRun(import.meta.url)) {
+    main().then((exitCode) => {
+        process.exitCode = exitCode;
+    }, (error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+export interface CommunityServiceSummary {
+    serviceId: string;
+    total: number;
+    counts: {
+        slow: number;
+        error: number;
+        down: number;
+    };
+    communityState: string;
+}
+export interface CommunitySummaryResponse {
+    windowMinutes: number;
+    updatedAt: string;
+    services: CommunityServiceSummary[];
+}
+export interface InstalledSignalServiceSummary {
+    serviceId: string;
+    total: number;
+    uniqueInstallationsApprox: number;
+    countsBySource: Record<string, number>;
+    countsBySymptom: Record<string, number>;
+    lastSignal: {
+        symptom: string;
+        source: string;
+        observedAt: string;
+    } | null;
+}
+export interface InstalledSignalSummaryResponse {
+    windowMinutes: number;
+    updatedAt: string;
+    services: InstalledSignalServiceSummary[];
+}
+export interface OfficialServiceStatus {
+    serviceId: string;
+    overall: string;
+    source: "official" | "not_connected";
+    updatedAt: string;
+}
+export interface OfficialSummaryResponse {
+    updatedAt: string;
+    services: OfficialServiceStatus[];
+}
+export interface StatusData {
+    community: CommunitySummaryResponse;
+    installedSignals: InstalledSignalSummaryResponse | null;
+    official: OfficialSummaryResponse | null;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@notjustyou/cli",
+  "version": "0.1.0",
+  "description": "Read-only command line status lookup for Not Just You AI service surfaces.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dobbylee/notjustyou.git",
+    "directory": "packages/notjustyou-cli"
+  },
+  "homepage": "https://github.com/dobbylee/notjustyou#readme",
+  "bugs": {
+    "url": "https://github.com/dobbylee/notjustyou/issues"
+  },
+  "keywords": [
+    "ai-status",
+    "status",
+    "cli",
+    "notjustyou"
+  ],
+  "type": "module",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "njy": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "pnpm run build",
+    "pack:dry-run": "pnpm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  }
+}