@powerbuilder/skill 1.0.6 → 1.0.8

package/README.md

@@ -42,6 +42,7 @@ The installer searches upward from your current directory to your home folder an
 ## Requirements
 
 - Node.js ≥ 18
+- [Power Platform CLI (PAC)](https://learn.microsoft.com/en-us/power-platform/developer/cli/introduction) — authenticated via `pac auth create`
 
 ---
 

package/codeapp.md

@@ -0,0 +1,123 @@
+# Power Apps Code App Skill
+
+> Part of the **PowerBuilder** toolkit by TuongDoan — AI agent skills for the Microsoft Power Platform.
+
+---
+
+## What is a Code App?
+
+Power Apps **Code Apps** let developers build custom web apps (React, Vue, or any framework) in their own IDE and run them natively on the Power Platform — with full access to Dataverse, 1,500+ connectors, Microsoft Entra authentication, and managed deployment.
+
+You write real code. The platform handles hosting, security, licensing, and ALM.
+
+**Key capabilities:**
+- Build with modern web frameworks (React, TypeScript, Vite)
+- Access Dataverse and 1,500+ Power Platform connectors directly from JavaScript
+- Microsoft Entra authentication out of the box
+- Publish and host line-of-business apps inside Power Platform
+- Full DLP, Conditional Access, and governance policy support
+- Simplified ALM and deployment via `pac code push`
+
+📖 [Official overview](https://learn.microsoft.com/en-us/power-apps/developer/code-apps/overview) · [Quickstart](https://learn.microsoft.com/en-us/power-apps/developer/code-apps/how-to/create-an-app-from-scratch)
+
+---
+
+## What Does This Skill Do?
+
+This skill gives your AI agent (Claude, Cursor, or Google Antigravity) a complete, opinionated playbook for delivering Code Apps end-to-end:
+
+| Phase | What happens |
+|-------|-------------|
+| **1. Scaffold** | `npx power-apps init` — creates the Vite + TypeScript project wired to Power Apps |
+| **2. Database** | Plan a Dataverse star schema, generate `planning-payload.json` |
+| **3. Provision** | Run `dataverse-flow.js` to create tables + relationships via Dataverse Web API |
+| **4. Connect** | `pac code add-data-source` — binds generated TypeScript services to your tables |
+| **5. Build UI** | 3-layer architecture: Components → Hooks → Generated Services. TailwindCSS default |
+| **6. Test** | `playwright-cli` with `--headed --persistent` against the `apps.powerapps.com` Local Play URL |
+| **7. Deploy** | `npm run build` then `pac code push` |
+
+---
+
+## Prerequisites
+
+Before using this skill, ensure the following are set up on your machine:
+
+### 1. Node.js (LTS)
+Download from [nodejs.org](https://nodejs.org). Verify with:
+```bash
+node --version   # should be v18 or higher
+```
+
+### 2. Power Platform CLI (PAC CLI)
+Required for authenticating to Power Platform, adding data sources, and deploying apps.
+
+**Install:**
+```bash
+# macOS / Linux
+npm install -g @microsoft/powerplatform-cli-osx
+# Windows
+npm install -g @microsoft/powerplatform-cli-windows
+```
+Or download the [standalone installer](https://learn.microsoft.com/en-us/power-platform/developer/cli/introduction).
+
+**Verify:**
+```bash
+pac --version
+```
+
+**Authenticate:**
+```bash
+pac auth create
+# A browser window will open — sign in with your Microsoft 365 account
+```
+
+### 3. A Power Platform Environment with Code Apps Enabled
+
+Code Apps must be enabled by an admin in your environment:
+
+1. Go to [Power Platform admin center](https://admin.powerplatform.microsoft.com)
+2. Navigate to **Manage → Environments** → select your environment
+3. Go to **Settings → Product → Features**
+4. Find **Power Apps code apps** and toggle **Enable code apps** ON
+5. Click **Save**
+
+### 4. Power Apps Premium License
+
+End-users running code apps require a **Power Apps Premium** license.  
+[See pricing](https://www.microsoft.com/power-platform/products/power-apps/pricing)
+
+### 5. Playwright CLI (auto-installed by this skill)
+Used for automated E2E testing. Installed automatically when you run `npx @powerbuilder/skill codeapp`.
+
+---
+
+## Install This Skill
+
+```bash
+npx @powerbuilder/skill codeapp
+```
+
+The installer will:
+1. Detect your AI agent folders (`.claude`, `.cursor`, `.gemini`)
+2. Copy the skill files into each one
+3. Install `@playwright/cli` globally
+4. Open Power Apps in a persistent browser for first-time login
+
+---
+
+## Quick Start (after skill is installed)
+
+Open your AI agent (Claude, Cursor, etc.) in an empty folder and ask:
+
+> *"Create a Power Apps Code App for managing [your use case]"*
+
+The agent will follow the skill's end-to-end phase sequence automatically.
+
+---
+
+## References
+
+- [Power Apps code apps overview](https://learn.microsoft.com/en-us/power-apps/developer/code-apps/overview)
+- [Quickstart: Create a code app from scratch](https://learn.microsoft.com/en-us/power-apps/developer/code-apps/how-to/create-an-app-from-scratch)
+- [Power Platform CLI reference](https://learn.microsoft.com/en-us/power-platform/developer/cli/introduction)
+- [Dataverse Web API](https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/overview)

package/lib/wizard-codeapp.js

@@ -1,4 +1,4 @@
-import { execSync, spawn } from 'child_process';
+import { execSync } from 'child_process';
 import chalk from 'chalk';
 import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
@@ -47,11 +47,45 @@ function runSilent(cmd) {
     }
 }
 
+function runOutput(cmd) {
+    try {
+        return execSync(cmd, { stdio: 'pipe', encoding: 'utf8' });
+    } catch {
+        return null;
+    }
+}
+
 // ─── skill asset path ────────────────────────────────────────────────────────
 
 // When installed via npm the skill files are at ../../skills/codeapp relative to this file
 const SKILL_SRC = path.resolve(__dirname, '..', 'skills', 'codeapp');
 
+// ─── PRE-FLIGHT — Check PAC CLI auth ─────────────────────────────────────────
+
+async function stepCheckPacCli() {
+    const output = runOutput('pac auth list');
+
+    // null = command failed to run = pac not installed
+    if (output === null) {
+        console.log();
+        err('Power Platform CLI (pac) was not found on this machine.');
+        log(chalk.dim('  Install it from: https://learn.microsoft.com/en-us/power-platform/developer/cli/introduction'));
+        log(chalk.dim('  Or via npm:  npm install -g @microsoft/powerplatform-cli-osx'));
+        console.log();
+        process.exit(1);
+    }
+
+    // pac is installed but no auth profile exists
+    if (output.includes('No profiles were found on this computer')) {
+        console.log();
+        warn('PAC CLI is installed but no authenticated profile was found.');
+        log(`  Run ${chalk.cyanBright('pac auth create')} to sign in, then re-run this installer.`);
+        console.log();
+        process.exit(1);
+    }
+}
+
+
 // ─── STEP 1 — Detect & confirm targets ───────────────────────────────────────
 
 async function stepDetectTargets() {
@@ -111,11 +145,20 @@ async function stepCopySkill(targets) {
 
     for (const t of targets) {
         const dest = path.join(t.skillsDir, 'powerapps-codeapp');
+        const exists = await fse.pathExists(dest);
+
+        if (exists) {
+            warn(`Existing skill found at ${chalk.dim(dest)}`);
+            warn(`It will be ${chalk.yellowBright('completely replaced')} with the latest version.`);
+            console.log();
+        }
+
         const spinner = ora({ text: `Copying to ${chalk.cyanBright(t.target)} …`, prefixText: '  ' }).start();
 
         try {
+            if (exists) await fse.remove(dest);   // wipe old files first
             await fse.ensureDir(dest);
-            await fse.copy(SKILL_SRC, dest, { overwrite: true });
+            await fse.copy(SKILL_SRC, dest);
             spinner.succeed(chalk.greenBright(`Installed → ${dest}`));
         } catch (e) {
             spinner.fail(chalk.red(`Failed to copy to ${dest}: ${e.message}`));
@@ -161,43 +204,21 @@ async function stepInstallPlaywright() {
 
 async function stepOpenPowerApps() {
     hr();
-    log(chalk.bold('Step 4/4  ·  First-time Power Apps login'));
+    log(chalk.bold('Step 4/4  ·  Power Apps login'));
     hr();
-    info('We will open powerapps.com in a persistent browser session.');
-    info('Sign in once — your session will be reused by playwright-cli in future runs.');
-    console.log();
-
-    const doLogin = await askConfirm('Open Power Apps now to complete login?');
-    if (!doLogin) {
-        warn('Skipped. Run the following manually when ready:');
-        warn('  playwright-cli open "https://make.powerapps.com" --headed --persistent');
-        console.log();
-        return;
-    }
-
-    info('Launching browser… (close the window when you are done signing in)');
+    log(`Opening ${chalk.cyanBright('make.powerapps.com')} in your browser…`);
+    log(chalk.dim('  Sign in with your Microsoft 365 account to connect Power Apps.'));
     console.log();
 
     try {
-        // Spawn detached so the wizard doesn't block waiting for the browser
-        const child = spawn(
-            'playwright-cli',
-            ['open', 'https://make.powerapps.com', '--headed', '--persistent'],
-            { stdio: 'inherit', detached: false }
-        );
-
-        await new Promise((resolve, reject) => {
-            child.on('exit', code => {
-                if (code === 0 || code === null) resolve();
-                else reject(new Error(`playwright-cli exited with code ${code}`));
-            });
-            child.on('error', reject);
-        });
-
-        ok('Browser session saved. You will not need to log in again.');
+        // Use the OS default browser — no playwright dependency needed here
+        const opener = process.platform === 'win32' ? 'start' :
+            process.platform === 'darwin' ? 'open' : 'xdg-open';
+        execSync(`${opener} https://make.powerapps.com`, { stdio: 'ignore' });
+        ok('Browser opened. Sign in and come back when you are done.');
     } catch (e) {
-        err(`Could not open browser: ${e.message}`);
-        warn('Run manually:  playwright-cli open "https://make.powerapps.com" --headed --persistent');
+        warn('Could not open browser automatically.');
+        log(`  Please open manually: ${chalk.cyanBright('https://make.powerapps.com')}`);
     }
     console.log();
 }
@@ -205,6 +226,8 @@ async function stepOpenPowerApps() {
 // ─── MAIN ─────────────────────────────────────────────────────────────────────
 
 export async function runCodeAppWizard() {
+    // Pre-flight: verify PAC CLI is installed and authenticated
+    await stepCheckPacCli();
     // Detect first, show summary, confirm — then execute
     const targets = await stepDetectTargets();
     await stepShowSummary(targets);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@powerbuilder/skill",
-    "version": "1.0.6",
+    "version": "1.0.8",
     "description": "PowerBuilder skill installer — drop production-ready AI agent skills into .cursor, .claude, or .gemini folders with one command.",
     "author": "TuongDoan",
     "license": "MIT",
@@ -11,7 +11,8 @@
     "files": [
         "bin/",
         "lib/",
-        "skills/"
+        "skills/",
+        "codeapp.md"
     ],
     "dependencies": {
         "chalk": "^5.3.0",