oauth-init 0.7.0 → 0.9.0

package/.agents/skills/crafting-effective-readmes/using-references.md

@@ -0,0 +1,35 @@
+# Using References
+
+Templates are your primary tool for writing READMEs. References provide depth - use them to refine your understanding or handle edge cases.
+
+**Tip:** Don't load all references at once. Pick the one most relevant to your situation.
+
+---
+
+### art-of-readme.md
+`references/art-of-readme.md`
+
+**Why:** The philosophy behind great READMEs - understanding how readers actually scan and evaluate projects
+**What:** Cognitive funneling (broad → specific), brevity as a feature, README as the "one-stop shop" that keeps users out of source code
+
+---
+
+### make-a-readme.md
+`references/make-a-readme.md`
+
+**Why:** Practical, section-by-section guidance for what to include
+**What:** Walks through each common section (Name, Description, Installation, Usage, etc.) with concrete suggestions. Good reminder: "too long is better than too short"
+
+---
+
+### standard-readme-spec.md
+`references/standard-readme-spec.md`
+
+**Why:** Formal specification when consistency or compliance matters
+**What:** Required vs optional sections, exact ordering, formatting rules. Useful for OSS projects wanting a standardized format.
+
+Examples:
+- `references/standard-readme-example-minimal.md` - Bare minimum compliant README
+- `references/standard-readme-example-maximal.md` - Full-featured with badges, ToC, all optional sections
+
+

package/README.md

@@ -1,15 +1,71 @@
 # oauth-init
 
-To install dependencies:
+Interactive CLI tool that guides you through setting up OAuth credentials for Google and GitHub.
+
+## What This Does
+
+Setting up OAuth involves navigating multiple console pages, copying IDs, and managing credentials. This CLI walks you through the entire process interactively - fetching your Google Cloud projects, opening the right console pages, validating your inputs, and saving credentials wherever you need them.
+
+## Features
+
+- **Google OAuth** - Fetches your GCP projects, opens consent screen and credentials pages, captures client ID/secret
+- **GitHub OAuth Apps** - One-click GitHub App manifest or manual OAuth App setup
+- **Smart defaults** - Remembers your current gcloud project, suggests callback URLs
+- **Flexible output** - Save to `.env`, `.env.local`, `.json`, or just print to console
+- **Non-interactive mode** - `--no-open` flag for CI/automated environments
+
+## Installation
 
 ```bash
-bun install
+# Using bun (recommended)
+bun install -g oauth-init
+
+# Using npm
+npm install -g oauth-init
 ```
 
-To run:
+## Usage
 
 ```bash
-bun run src/cli.ts
+# Run interactive setup
+oauth-init
+
+# Run without opening browser pages
+oauth-init --no-open
+
+# Minimal output
+oauth-init --quiet
 ```
 
-This project was created using `bun init` in bun v1.3.9. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+The CLI will:
+1. Ask for your project name
+2. Select which OAuth providers to configure
+3. Guide you through each provider's setup flow
+4. Save credentials to your chosen location
+
+## Supported Providers
+
+| Provider | Setup Type |
+|----------|------------|
+| Google | OAuth 2.0 (External) |
+| GitHub | OAuth App, GitHub App |
+
+## Tech Stack
+
+- **Runtime**: Bun
+- **CLI UI**: @clack/prompts
+- **Shell**: execa
+- **Browser**: open
+
+## How It Works
+
+The CLI orchestrates the OAuth setup by:
+
+1. **Discovery** - Uses `gcloud` CLI to fetch your Google Cloud projects
+2. **Navigation** - Opens the correct Google Cloud Console and GitHub pages
+3. **Capture** - Prompts for client ID and secret with validation
+4. **Output** - Writes credentials to the chosen format
+
+## License
+
+MIT

package/dist/index.js

@@ -9171,13 +9171,12 @@ defineLazyProperty(apps, "safari", () => detectPlatformBinary({
 var open_default = open;
 
 // src/index.ts
-import { writeFile, access, readFile, unlink } from "fs/promises";
+import { writeFile as writeFile2, unlink } from "fs/promises";
 import path7 from "path";
 import http from "http";
-var globalConfig = {
-  quiet: false,
-  noOpen: false
-};
+
+// src/lib/save-credentials.ts
+import { writeFile, readFile, access } from "fs/promises";
 async function saveCredentials(clientId, clientSecret, provider, saveOption) {
   const envKeyId = `${provider.toUpperCase()}_CLIENT_ID`;
   const envKeySecret = `${provider.toUpperCase()}_CLIENT_SECRET`;
@@ -9215,9 +9214,54 @@ ${envKeySecret}=${clientSecret}`;
   R2.success(`Credentials saved to ${envPath}`);
 }
 
+// src/index.ts
+var globalConfig = {
+  quiet: false,
+  noOpen: false
+};
+async function checkGcloudAuth() {
+  const s = bt2();
+  s.start("Checking gcloud CLI...");
+  try {
+    await execa("gcloud", ["version"]);
+  } catch {
+    s.stop("gcloud CLI not found.");
+    R2.error(`gcloud CLI is required for Google OAuth setup.
+` + `Install it: https://cloud.google.com/sdk/docs/install
+` + "Then run: gcloud auth login");
+    return false;
+  }
+  s.stop("gcloud CLI found.");
+  const authSpinner = bt2();
+  authSpinner.start("Checking gcloud authentication...");
+  try {
+    const { stdout } = await execa("gcloud", [
+      "auth",
+      "list",
+      "--format=value(account)",
+      "--filter=status:ACTIVE"
+    ]);
+    if (!stdout.trim()) {
+      authSpinner.stop("Not authenticated.");
+      R2.error("Please run: gcloud auth login");
+      return false;
+    }
+    authSpinner.stop(`Authenticated as: ${stdout.trim()}`);
+    return true;
+  } catch {
+    authSpinner.stop("Authentication check failed.");
+    return false;
+  }
+}
+
 class GoogleAuthProvider {
   async run(_appName) {
     try {
+      const isAuthenticated = await checkGcloudAuth();
+      if (!isAuthenticated) {
+        R2.error("Please install gcloud CLI and authenticate before continuing.");
+        process.exit(1);
+      }
       const googleLoading = bt2();
       googleLoading.start("Fetching google cloud projects");
       const { stdout: currentProject } = await execa("gcloud", [
@@ -9365,7 +9409,7 @@ class GitHubAuthProvider {
     const saveOption = await this.askSaveOption();
     if (Ct(saveOption))
       return Ne("Setup aborted.");
-    const PORT = 3001;
+    const PORT = 3004;
     const REDIRECT_URI = `http://localhost:${PORT}/callback`;
     const manifest = {
       name: "oauth-init-app",
@@ -9389,7 +9433,7 @@ class GitHubAuthProvider {
         </html>
       `;
     const tempPath = path7.join(process.cwd(), "github-setup.html");
-    await writeFile(tempPath, htmlContent);
+    await writeFile2(tempPath, htmlContent);
     R2.step("GitHub App Configuration");
     R2.message("Opening GitHub with your manifest...");
     if (!globalConfig.noOpen) {
@@ -9481,7 +9525,7 @@ class Orchestrator {
         R2.step("Google OAuth Setup");
         const googleOauthCallback = await Ze({
           message: "Enter the Google OAuth callback URL:",
-          placeholder: "https://example.com/oauth/callback",
+          placeholder: "https://localhost:3000/oauth/callback/google",
           defaultValue: `http://localhost:3000/oauth/callback/google`
         });
         if (Ct(googleOauthCallback)) {
@@ -9494,7 +9538,7 @@ class Orchestrator {
         R2.step("GitHub OAuth Setup");
         const githubOauthCallback = await Ze({
           message: "Enter the GitHub OAuth callback URL:",
-          placeholder: "https://example.com/oauth/callback",
+          placeholder: "http://localhost:3000/oauth/callback/github",
           defaultValue: `http://localhost:3000/oauth/callback/github`
         });
         if (Ct(githubOauthCallback)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oauth-init",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "CLI for setting up OAuth providers for your project",
   "license": "MIT",
   "type": "module",

package/skills-lock.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "skills": {
+    "crafting-effective-readmes": {
+      "source": "softaworks/agent-toolkit",
+      "sourceType": "github",
+      "computedHash": "c931a8c22160e8925400778fcb2266b5d1df762f3052edba65f72479f79f2d6c"
+    }
+  }
+}