@powerbuilder/skill 1.0.5 → 1.0.7

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/banner.js

@@ -4,15 +4,14 @@ export function printBanner() {
     const cyan = chalk.cyanBright.bold;
     const yellow = chalk.yellowBright.bold;
     const dim = chalk.dim;
-    const green = chalk.greenBright;
 
     console.log();
-    console.log(cyan('  ██████╗  ██████╗ ██╗    ██╗███████╗██████╗ ██████╗ ██╗   ██╗██╗██╗     ██████╗ ███████╗██████╗ '));
-    console.log(cyan('  ██╔══██╗██╔═══██╗██║    ██║██╔════╝██╔══██╗██╔══██╗██║   ██║██║██║     ██╔══██╗██╔════╝██╔══██╗'));
-    console.log(cyan('  ██████╔╝██║   ██║██║ █╗ ██║█████╗  ██████╔╝██████╔╝██║   ██║██║██║     ██║  ██║█████╗  ██████╔╝'));
-    console.log(cyan('  ██╔═══╝ ██║   ██║██║███╗██║██╔══╝  ██╔══██╗██╔══██╗██║   ██║██║██║     ██║  ██║██╔══╝  ██╔══██╗'));
-    console.log(cyan('  ██║     ╚██████╔╝╚███╔███╔╝███████╗██║  ██║██████╔╝╚██████╔╝██║███████╗██████╔╝███████╗██║  ██║'));
-    console.log(cyan('  ╚═╝      ╚═════╝  ╚══╝╚══╝ ╚══════╝╚═╝  ╚═╝╚═════╝  ╚═════╝ ╚═╝╚══════╝╚═════╝ ╚══════╝╚═╝  ╚═╝'));
+    console.log(cyan('  ██████╗  ██████╗ ██╗    ██╗███████╗██████╗   ██████╗ ██╗   ██╗██╗██╗     ██████╗ ███████╗██████╗ '));
+    console.log(cyan('  ██╔══██╗██╔═══██╗██║    ██║██╔════╝██╔══██╗  ██╔══██╗██║   ██║██║██║     ██╔══██╗██╔════╝██╔══██╗'));
+    console.log(cyan('  ██████╔╝██║   ██║██║ █╗ ██║█████╗  ██████╔╝  ██████╔╝██║   ██║██║██║     ██║  ██║█████╗  ██████╔╝'));
+    console.log(cyan('  ██╔═══╝ ██║   ██║██║███╗██║██╔══╝  ██╔══██╗  ██╔══██╗██║   ██║██║██║     ██║  ██║██╔══╝  ██╔══██╗'));
+    console.log(cyan('  ██║     ╚██████╔╝╚███╔███╔╝███████╗██║  ██║  ██████╔╝╚██████╔╝██║███████╗██████╔╝███████╗██║  ██║'));
+    console.log(cyan('  ╚═╝      ╚═════╝  ╚══╝╚══╝ ╚══════╝╚═╝  ╚═╝  ╚═════╝  ╚═════╝ ╚═╝╚══════╝╚═════╝ ╚══════╝╚═╝  ╚═╝'));
     console.log();
     console.log('  ' + yellow('⚡ Power Apps Code App Skill') + dim('  ·  by TuongDoan  ·  © 2026'));
     console.log();

package/lib/detect-targets.js

@@ -3,13 +3,10 @@ import { existsSync } from 'fs';
 import os from 'os';
 
 /**
- * Search for supported AI agent root folders starting from cwd up to home dir.
- * Returns an array of { target, agentFolder, dir } objects for each found target.
- *
- * Supported targets:
- *   - .cursor   → skills go into  <target>/.cursor/rules/  (or just .cursor/skills/)
- *   - .claude   → skills go into  <target>/.claude/skills/
- *   - .gemini   → skills go into  <target>/.gemini/antigravity/skills/
+ * Detect where to install skills:
+ *   - .cursor   → optional: skip if folder doesn't exist
+ *   - .gemini   → optional: skip if folder doesn't exist
+ *   - .claude   → always: create ~/.claude if it doesn't exist
  */
 export function detectTargets(startDir = process.cwd()) {
     const home = os.homedir();
@@ -22,15 +19,15 @@ export function detectTargets(startDir = process.cwd()) {
         dirs.push(current);
         if (current === home) break;
         const parent = path.dirname(current);
-        if (parent === current) break; // filesystem root
+        if (parent === current) break;
         current = parent;
     }
 
     for (const dir of dirs) {
         const cursorDir = path.join(dir, '.cursor');
-        const claudeDir = path.join(dir, '.claude');
         const geminiDir = path.join(dir, '.gemini');
 
+        // .cursor — optional: only add if the folder already exists
         if (existsSync(cursorDir)) {
             targets.push({
                 target: '.cursor',
@@ -40,15 +37,8 @@ export function detectTargets(startDir = process.cwd()) {
                 dir,
             });
         }
-        if (existsSync(claudeDir)) {
-            targets.push({
-                target: '.claude',
-                label: 'Claude',
-                agentFolder: claudeDir,
-                skillsDir: path.join(claudeDir, 'skills'),
-                dir,
-            });
-        }
+
+        // .gemini — optional: only add if the folder already exists
         if (existsSync(geminiDir)) {
             targets.push({
                 target: '.gemini',
@@ -60,6 +50,16 @@ export function detectTargets(startDir = process.cwd()) {
         }
     }
 
+    // .claude — always install to home dir; folder will be created if missing
+    const claudeDir = path.join(home, '.claude');
+    targets.push({
+        target: '.claude',
+        label: 'Claude',
+        agentFolder: claudeDir,
+        skillsDir: path.join(claudeDir, 'skills'),
+        dir: home,
+    });
+
     // Deduplicate by agentFolder
     const seen = new Set();
     return targets.filter(t => {

package/lib/wizard-codeapp.js

@@ -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() {
@@ -205,6 +239,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.5",
+    "version": "1.0.7",
     "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",