gigabuddy 0.0.1 → 0.2.0

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "gigabuddy",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "The Gigabuddy CLI — sign in, and install @gigabuddy packages as yourself.",
   "type": "module",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "homepage": "https://gigabuddy.com",
   "bin": {
     "gigabuddy": "bin/cli.js"
@@ -16,7 +16,8 @@
     "bin/**/*.js",
     "index.js",
     "src/**/*.d.ts",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=20"

package/src/lib/commands.d.ts

@@ -1,11 +1,3 @@
-/**
- * The `gigabuddy` commands. Kept separate from bin/cli.ts (which only parses
- * argv and dispatches) so each one is testable without spawning a process.
- *
- * Everything here is deliberately thin: sign in, prove who you are to the npm
- * door, say what state you're in, sign out. The platform's actual capabilities
- * live behind hosted doors — this client never grows tool implementations.
- */
 import { type UserCredentials } from '@gigabuddy/client-core';
 export declare const PRODUCTION_AUTH_URL = "https://auth.gigabuddy.com";
 export declare const PRODUCTION_API_URL = "https://api.gigabuddy.com";
@@ -33,5 +25,11 @@ export declare function loginCommand(env: Env): Promise<void>;
  */
 export declare function npmLoginCommand(env: Env): Promise<void>;
 export declare function npmLogoutCommand(env: Env): void;
-export declare function logoutCommand(env: Env): void;
-export declare function statusCommand(): void;
+export declare function logoutCommand(env: Env): Promise<void>;
+/**
+ * `gigabuddy doctor [package]` — why isn't this working?
+ *
+ * Exits non-zero when it found something wrong, so CI can gate on it.
+ */
+export declare function doctorCommand(env: Env, packageName?: string): Promise<void>;
+export declare function statusCommand(): Promise<void>;

package/src/lib/doctor.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `gigabuddy doctor` — answer "why doesn't my install work?" in one command.
+ *
+ * This exists because of a deliberate property of the registry door: a denied
+ * read is answered as an npm-shaped `404 no such package`, so that private
+ * package names don't enumerate to people who can't read them. Correct for the
+ * door, miserable for the human — "not found" looks identical whether you typed
+ * the name wrong, aren't signed in, have an expired credential, or simply
+ * haven't been given access. npm cannot tell you which, and neither can the
+ * registry without leaking the thing it's protecting.
+ *
+ * So the client says it instead. It holds the pieces the door can't safely
+ * reveal — who you are signed in as, whether that session is live, what npm
+ * will actually resolve — and turns a bare 404 into a sentence with a next
+ * action in it.
+ *
+ * Every check is independent and never throws: a doctor that dies on the first
+ * problem is useless precisely when you need it.
+ */
+import { type UserCredentials } from '@gigabuddy/client-core';
+export type CheckStatus = 'ok' | 'warn' | 'fail' | 'skip';
+export interface Check {
+    label: string;
+    status: CheckStatus;
+    detail?: string;
+}
+export interface DoctorResult {
+    checks: Check[];
+    /** What to actually do next, in order. Empty when everything is healthy. */
+    advice: string[];
+}
+export interface DoctorDeps {
+    readNpmrc: () => string;
+    /** `npm config get @gigabuddy:registry` — the EFFECTIVE value, all layers merged. */
+    npmEffectiveRegistry: () => string | null;
+    fetchImpl: typeof fetch;
+    /** Every .npmrc npm consults ahead of the user-level file, nearest first. */
+    shadowingNpmrcFiles: () => {
+        path: string;
+        contents: string;
+    }[];
+    nodeVersion: string;
+    loadCredentials: (staging: boolean) => UserCredentials | null;
+}
+export declare function runDoctor(deps: DoctorDeps, packageName?: string): Promise<DoctorResult>;
+/** Render for a terminal. Colour only when one is attached and NO_COLOR is unset. */
+export declare function formatDoctor(result: DoctorResult, colour: boolean): string;