@fractary/faber-cli 1.3.3 → 1.3.4

package/dist/commands/auth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAehD;AAwVD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BpC;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAehD;AAwYD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}

package/dist/commands/auth/index.js

@@ -5,7 +5,7 @@ import { Command } from 'commander';
 import * as readline from 'readline/promises';
 import chalk from 'chalk';
 import fs from 'fs/promises';
-import { generateAppManifest, getManifestCreationUrl, exchangeCodeForCredentials, validateAppCredentials, getInstallationId, savePrivateKey, formatPermissionsDisplay, } from '../../lib/github-app-setup.js';
+import { generateAppManifest, generateManifestHtml, exchangeCodeForCredentials, validateAppCredentials, getInstallationId, savePrivateKey, } from '../../lib/github-app-setup.js';
 import { parseCodeFromUrl, validateManifestCode, detectGitHubContext, isGitRepository, } from '../../utils/github-manifest.js';
 /**
  * Create the auth setup command
@@ -26,7 +26,9 @@ export function createAuthSetupCommand() {
  * Run the setup flow
  */
 async function runSetup(options) {
-    console.log(chalk.bold('\n🔐 GitHub App Authentication Setup\n'));
+    // Force output to flush immediately
+    process.stdout.write('\n🔐 GitHub App Authentication Setup\n\n');
+    process.stdout.write('Initializing...\n');
     // Step 1: Detect or prompt for GitHub context
     let org = options.org;
     let repo = options.repo;
@@ -73,22 +75,65 @@ async function runSetup(options) {
         console.log(JSON.stringify(manifest, null, 2));
         console.log();
     }
-    // Step 4: Display creation instructions
+    // Step 4: Generate and open manifest HTML
     console.log(chalk.bold('━'.repeat(60)));
     console.log(chalk.bold('📋 STEP 1: Create the GitHub App'));
     console.log(chalk.bold('━'.repeat(60)));
     console.log();
-    const creationUrl = getManifestCreationUrl(manifest);
-    console.log('Please click this URL to create your GitHub App:\n');
-    console.log(chalk.cyan.bold(`👉 ${creationUrl}\n`));
-    console.log('The app will request these permissions:');
-    console.log(formatPermissionsDisplay(manifest));
-    console.log();
+    const htmlContent = generateManifestHtml(manifest, org);
+    const os = await import('os');
+    const path = await import('path');
+    // Detect WSL and use Windows-accessible temp directory
+    let tmpDir = os.tmpdir();
+    const isWsl = process.platform === 'linux' && os.release().toLowerCase().includes('microsoft');
+    if (isWsl) {
+        // Use current working directory for WSL (it's usually in /mnt/c which is Windows-accessible)
+        tmpDir = process.cwd();
+    }
+    const htmlPath = path.join(tmpDir, `faber-github-app-${Date.now()}.html`);
+    try {
+        await fs.writeFile(htmlPath, htmlContent, 'utf-8');
+        console.log(chalk.gray(`✓ Generated manifest form\n`));
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to create manifest file'));
+        if (error instanceof Error) {
+            console.error(chalk.red(error.message));
+        }
+        process.exit(1);
+    }
+    console.log('Opening GitHub App creation page in your browser...\n');
+    // Open HTML file in default browser (safe - we control the path)
+    const { execFile } = await import('child_process');
+    const { promisify } = await import('util');
+    const execFileAsync = promisify(execFile);
+    try {
+        if (process.platform === 'darwin') {
+            await execFileAsync('open', [htmlPath]);
+        }
+        else if (process.platform === 'win32') {
+            // Windows requires cmd /c start for file associations
+            await execFileAsync('cmd', ['/c', 'start', '', htmlPath]);
+        }
+        else {
+            // Linux/Unix
+            await execFileAsync('xdg-open', [htmlPath]);
+        }
+    }
+    catch (error) {
+        console.log(chalk.yellow('\n⚠️  Could not open browser automatically.'));
+        console.log(chalk.yellow(`Please open this file manually:\n  ${htmlPath}\n`));
+    }
+    console.log(chalk.bold('In your browser:'));
+    console.log('  1. Review the app permissions');
+    console.log('  2. Click the green "Create GitHub App →" button');
+    console.log('  3. GitHub will ask you to confirm - click "Create GitHub App" again');
+    console.log('  4. After creation, look at the browser URL bar\n');
     const rl1 = readline.createInterface({
         input: process.stdin,
         output: process.stdout,
     });
-    await rl1.question('Press Enter when you have created the app...');
+    await rl1.question('Press Enter after you have clicked the Create button in your browser...');
     rl1.close();
     // Step 5: Prompt for code
     console.log();

package/dist/lib/github-app-setup.d.ts

@@ -81,10 +81,21 @@ export interface AppCredentials {
  */
 export declare function generateAppManifest(config: ManifestConfig): GitHubAppManifest;
 /**
- * Generate GitHub App creation URL
+ * Generate HTML content for manifest submission
  *
- * Note: GitHub does not support pre-filled manifests via URL parameters.
- * Users must manually fill in the form or use the manifest conversion API.
+ * The GitHub App Manifest flow requires POSTing a form to GitHub.
+ * Since CLI cannot POST directly, we generate an HTML file that the user
+ * opens in their browser and clicks to submit.
+ *
+ * @param manifest - The app manifest to submit
+ * @param organization - GitHub organization name
+ * @returns HTML content ready to save to file
+ */
+export declare function generateManifestHtml(manifest: GitHubAppManifest, organization: string): string;
+/**
+ * Generate GitHub App creation URL (legacy - prefer generateManifestHtml)
+ *
+ * @deprecated Use generateManifestHtml() instead for proper manifest flow
  */
 export declare function getManifestCreationUrl(manifest: GitHubAppManifest): string;
 /**

package/dist/lib/github-app-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-app-setup.d.ts","sourceRoot":"","sources":["../../src/lib/github-app-setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"github-app-setup.d.ts","sourceRoot":"","sources":["../../src/lib/github-app-setup.ts"],"names":[],"mappings":"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"}

package/dist/lib/github-app-setup.js

@@ -19,6 +19,7 @@ export function generateAppManifest(config) {
         hook_attributes: {
             url: 'https://example.com/webhook', // Required but not used
         },
+        redirect_url: 'https://example.com', // Required by GitHub for manifest flow
         description: 'FABER CLI for automated workflow management, issue tracking, and repository operations.',
         public: false,
         default_permissions: {
@@ -31,13 +32,136 @@ export function generateAppManifest(config) {
     };
 }
 /**
- * Generate GitHub App creation URL
+ * Generate HTML content for manifest submission
  *
- * Note: GitHub does not support pre-filled manifests via URL parameters.
- * Users must manually fill in the form or use the manifest conversion API.
+ * The GitHub App Manifest flow requires POSTing a form to GitHub.
+ * Since CLI cannot POST directly, we generate an HTML file that the user
+ * opens in their browser and clicks to submit.
+ *
+ * @param manifest - The app manifest to submit
+ * @param organization - GitHub organization name
+ * @returns HTML content ready to save to file
+ */
+export function generateManifestHtml(manifest, organization) {
+    const manifestJson = JSON.stringify(manifest, null, 2);
+    const targetUrl = organization
+        ? `https://github.com/organizations/${organization}/settings/apps/new`
+        : 'https://github.com/settings/apps/new';
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>FABER CLI - Create GitHub App</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+      max-width: 600px;
+      margin: 50px auto;
+      padding: 20px;
+      background: #f6f8fa;
+    }
+    .container {
+      background: white;
+      border-radius: 8px;
+      padding: 30px;
+      box-shadow: 0 2px 8px rgba(0,0,0,0.1);
+    }
+    h1 {
+      margin-top: 0;
+      color: #24292f;
+    }
+    .info {
+      background: #dff6ff;
+      border-left: 4px solid #0969da;
+      padding: 12px 16px;
+      margin: 20px 0;
+      border-radius: 4px;
+    }
+    button {
+      background: #2da44e;
+      color: white;
+      border: none;
+      padding: 12px 24px;
+      font-size: 16px;
+      border-radius: 6px;
+      cursor: pointer;
+      width: 100%;
+      margin-top: 20px;
+    }
+    button:hover {
+      background: #2c974b;
+    }
+    .manifest {
+      background: #f6f8fa;
+      border: 1px solid #d0d7de;
+      border-radius: 6px;
+      padding: 16px;
+      margin: 16px 0;
+      overflow-x: auto;
+    }
+    .manifest pre {
+      margin: 0;
+      font-family: 'SF Mono', Monaco, monospace;
+      font-size: 12px;
+    }
+    .instructions {
+      color: #57606a;
+      margin: 16px 0;
+      line-height: 1.6;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>🔐 Create FABER GitHub App</h1>
+
+    <div class="info">
+      <strong>Step 1 of 2:</strong> Click the button below to create your GitHub App
+    </div>
+
+    <div class="instructions">
+      <p>This will create a GitHub App for <strong>${organization}</strong> with the following permissions:</p>
+      <ul>
+        <li>Contents: Write</li>
+        <li>Issues: Write</li>
+        <li>Pull Requests: Write</li>
+        <li>Metadata: Read</li>
+      </ul>
+    </div>
+
+    <details>
+      <summary style="cursor: pointer; color: #0969da;">Show manifest JSON</summary>
+      <div class="manifest">
+        <pre>${manifestJson}</pre>
+      </div>
+    </details>
+
+    <form action="${targetUrl}" method="post" id="manifestForm">
+      <input type="hidden" name="manifest" value='${manifestJson.replace(/'/g, '&#39;')}'>
+      <button type="submit">Create GitHub App →</button>
+    </form>
+
+    <div class="instructions" style="margin-top: 20px; font-size: 14px;">
+      <p><strong>What happens next:</strong></p>
+      <ol>
+        <li>GitHub will show you the app details for review</li>
+        <li>Click "Create GitHub App" to confirm</li>
+        <li>GitHub will redirect you to a URL with a code</li>
+        <li>Copy the code and paste it into the CLI</li>
+      </ol>
+    </div>
+  </div>
+</body>
+</html>`;
+}
+/**
+ * Generate GitHub App creation URL (legacy - prefer generateManifestHtml)
+ *
+ * @deprecated Use generateManifestHtml() instead for proper manifest flow
  */
 export function getManifestCreationUrl(manifest) {
-    // GitHub App creation page
+    // For backward compatibility, return the basic GitHub App creation page
     return 'https://github.com/settings/apps/new';
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractary/faber-cli",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "FABER CLI - Command-line interface for FABER development toolkit",
   "main": "dist/index.js",
   "bin": {