prizmkit 1.1.53 → 1.1.54

package/bin/create-prizmkit.js

@@ -41,6 +41,8 @@ program
   .option('--no-playwright-cli', 'Disable playwright-cli installation')
   .option('--open-cli', 'Install opencli browser tool (default: true)')
   .option('--no-open-cli', 'Disable opencli installation')
+  .option('--open-cli-auto-download', 'Auto-download opencli extension if missing (default: true)')
+  .option('--no-open-cli-auto-download', 'Skip auto-download, show manual steps only')
   .option('--rules <preset>', 'Rules preset: recommended, minimal, or none', 'recommended')
   .option('--ai-cli <command>', 'AI CLI executable command (e.g. cbc, claude, claude-internal)')
   .option('--external-skills <names>', 'Comma-separated external skill names to install (e.g. find-skills,impeccable)')

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.1.53",
-  "bundledAt": "2026-05-24T05:20:15.152Z",
-  "bundledFrom": "156de40"
+  "frameworkVersion": "1.1.54",
+  "bundledAt": "2026-05-24T14:07:35.874Z",
+  "bundledFrom": "4a97a4a"
 }

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.53",
+  "version": "1.1.54",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.53",
+  "version": "1.1.54",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {

package/src/index.js

@@ -69,6 +69,7 @@ export async function runScaffold(directory, options) {
       pipeline: options.pipeline !== false,
       playwrightCli: options.playwrightCli !== false,
       openCli: options.openCli !== false,
+      openCliAutoDownload: options.openCliAutoDownload !== false,
       rules: options.rules || 'recommended',
       aiCli: options.aiCli || '',
       externalSkills: options.externalSkills ? options.externalSkills.split(',').map(s => s.trim()).filter(Boolean) : [],
@@ -198,6 +199,14 @@ export async function runScaffold(directory, options) {
       default: true,
     });
 
+    let openCliAutoDownload = true;
+    if (openCli) {
+      openCliAutoDownload = await confirm({
+        message: '检测到 Chrome Browser Bridge 扩展缺失时，自动下载扩展包？\n  (仍需手动在 Chrome 中加载，但可省去下载解压步骤)',
+        default: true,
+      });
+    }
+
     // 5. Rules 预设
     const rulesPreset = await select({
       message: '安装 AI 行为规则 (rules):',
@@ -248,6 +257,7 @@ export async function runScaffold(directory, options) {
       pipeline,
       playwrightCli,
       openCli,
+      openCliAutoDownload,
       rules: rulesPreset,
       aiCli: aiCli || '',
       externalSkills: selectedExternalSkills,

package/src/scaffold.js

@@ -778,6 +778,27 @@ export async function installPlaywrightCli(projectRoot, dryRun) {
     console.log(chalk.yellow(`      ⚠ Skills install skipped: ${e.message}`));
     console.log(chalk.yellow('      ⚠ Run manually: playwright-cli install --skills'));
   }
+
+  // Install Playwright browser binary (needed for E2E testing via prizmkit-test)
+  try {
+    const cacheDir = process.env.PLAYWRIGHT_BROWSERS_PATH
+      || path.join(process.env.HOME || process.env.USERPROFILE || '.',
+        process.platform === 'darwin' ? 'Library/Caches/ms-playwright'
+        : process.platform === 'win32' ? 'AppData/Local/ms-playwright'
+        : '.cache/ms-playwright');
+    const hasChromium = fs.pathExistsSync(cacheDir)
+      && fs.readdirSync(cacheDir).some(d => d.startsWith('chromium-'));
+    if (hasChromium) {
+      console.log(chalk.green('      ✓ Playwright Chromium (already installed)'));
+    } else {
+      console.log(chalk.blue('      ⏳ Installing Playwright Chromium (needed for E2E testing)...'));
+      execSync('npx --yes playwright install chromium', { stdio: 'pipe', timeout: 180000 });
+      console.log(chalk.green('      ✓ Playwright Chromium installed'));
+    }
+  } catch (e) {
+    console.log(chalk.yellow(`      ⚠ Playwright browser install skipped: ${e.message}`));
+    console.log(chalk.yellow('      ⚠ Run manually: npx playwright install chromium'));
+  }
 }
 
 // ============================================================
@@ -788,7 +809,7 @@ export async function installPlaywrightCli(projectRoot, dryRun) {
  * 安装 opencli（全局 npm 包）
  * 用于浏览器交互验证，复用 Chrome 已登录会话（OAuth/SSO/第三方集成）
  */
-export async function installOpenCli(projectRoot, dryRun) {
+export async function installOpenCli(projectRoot, dryRun, autoDownload = true) {
   if (dryRun) {
     console.log(chalk.gray('      [dry-run] @jackwener/opencli (global install)'));
     return;
@@ -811,10 +832,105 @@ export async function installOpenCli(projectRoot, dryRun) {
     }
   }
 
-  // Note: opencli requires Chrome + Browser Bridge extension for browser-backed commands.
-  // The extension must be installed manually — see: https://github.com/jackwener/opencli
-  console.log(chalk.gray('      ℹ OpenCLI requires Chrome + Browser Bridge extension for browser commands'));
-  console.log(chalk.gray('      ℹ Run "opencli doctor" to verify connectivity'));
+  // Verify opencli connectivity — Chrome Browser Bridge extension is a manual install
+  try {
+    const doctorOutput = execSync('opencli doctor 2>&1', { stdio: 'pipe', timeout: 15000 }).toString();
+    if (doctorOutput.includes('[MISSING] Extension') || doctorOutput.includes('[FAIL] Connectivity')) {
+      console.log(chalk.yellow('      ⚠ Chrome Browser Bridge extension is NOT connected'));
+
+      if (autoDownload) {
+        await downloadOpenCliExtension(projectRoot);
+      } else {
+        printOpenCliManualSteps();
+      }
+    } else {
+      console.log(chalk.green('      ✓ opencli connectivity verified'));
+    }
+  } catch {
+    // doctor command itself failed — already warned about install issues
+  }
+}
+
+// ============================================================
+// OpenCLI Extension 下载/指引
+// ============================================================
+
+/**
+ * 从 GitHub releases 下载并解压 opencli Chrome 扩展。
+ * 省去用户手动下载解压步骤，但仍需在 Chrome 中手动加载。
+ */
+async function downloadOpenCliExtension(projectRoot) {
+  const extDir = path.join(process.env.HOME || process.env.USERPROFILE || '.', '.opencli', 'extension');
+
+  // Check if already downloaded
+  const manifestPath = path.join(extDir, 'manifest.json');
+  if (fs.pathExistsSync(manifestPath)) {
+    console.log(chalk.green(`      ✓ Extension already downloaded at ${extDir}`));
+    printOpenCliLoadSteps(extDir);
+    return;
+  }
+
+  try {
+    console.log(chalk.blue('      ⏳ Fetching latest extension release info...'));
+    const releaseJson = execSync(
+      'curl -sL https://api.github.com/repos/jackwener/OpenCLI/releases/latest',
+      { stdio: 'pipe', timeout: 30000 }
+    ).toString();
+    const release = JSON.parse(releaseJson);
+    const extAsset = release.assets?.find(a => a.name?.startsWith('opencli-extension-') && a.name?.endsWith('.zip'));
+
+    if (!extAsset) {
+      console.log(chalk.yellow('      ⚠ Could not find extension asset in latest release'));
+      printOpenCliManualSteps();
+      return;
+    }
+
+    console.log(chalk.blue(`      ⏳ Downloading ${extAsset.name}...`));
+    const tmpZip = path.join(extDir, '..', '.opencli-ext-tmp.zip');
+    await fs.ensureDir(path.dirname(tmpZip));
+    execSync(`curl -sL "${extAsset.browser_download_url}" -o "${tmpZip}"`, { stdio: 'pipe', timeout: 60000 });
+
+    // Extract (use unzip on macOS/Linux, tar on Windows fallback)
+    console.log(chalk.blue(`      ⏳ Extracting to ${extDir}...`));
+    await fs.ensureDir(extDir);
+    execSync(`unzip -o "${tmpZip}" -d "${extDir}"`, { stdio: 'pipe', timeout: 30000 });
+    await fs.remove(tmpZip);
+
+    console.log(chalk.green(`      ✓ Extension extracted to ${extDir}`));
+    printOpenCliLoadSteps(extDir);
+  } catch (e) {
+    console.log(chalk.yellow(`      ⚠ Extension download failed: ${e.message}`));
+    printOpenCliManualSteps();
+  }
+}
+
+/**
+ * 显示手动安装步骤（兜底路径）。
+ */
+function printOpenCliManualSteps() {
+  console.log(chalk.cyan('      ┌─────────────────────────────────────────────────────────────┐'));
+  console.log(chalk.cyan('      │  To enable opencli browser control:                         │'));
+  console.log(chalk.cyan('      │  1. Download extension from:                                │'));
+  console.log(chalk.cyan('      │     https://github.com/jackwener/opencli/releases           │'));
+  console.log(chalk.cyan('      │  2. Unzip the extension file                                │'));
+  console.log(chalk.cyan('      │  3. Open chrome://extensions/ → Enable Developer Mode       │'));
+  console.log(chalk.cyan('      │  4. Click "Load unpacked" → select the extension folder     │'));
+  console.log(chalk.cyan('      │  5. Run "opencli doctor" to verify connectivity             │'));
+  console.log(chalk.cyan('      └─────────────────────────────────────────────────────────────┘'));
+}
+
+/**
+ * 显示加载已解压扩展的指引（已自动下载解压后）。
+ */
+function printOpenCliLoadSteps(extDir) {
+  console.log(chalk.yellow('      ⚠ Browser commands will NOT work until the extension is loaded in Chrome'));
+  console.log(chalk.cyan('      ┌─────────────────────────────────────────────────────────────┐'));
+  console.log(chalk.cyan('      │  To complete setup:                                         │'));
+  console.log(chalk.cyan(`      │  1. Open chrome://extensions/ → Enable Developer Mode        │`));
+  console.log(chalk.cyan(`      │  2. Click "Load unpacked" → select:                          │`));
+  console.log(chalk.cyan(`      │     ${extDir}`));
+  console.log(chalk.cyan('      │  3. Run "opencli doctor" to verify connectivity             │'));
+  console.log(chalk.cyan('      └─────────────────────────────────────────────────────────────┘'));
 }
 
 // ============================================================
@@ -852,11 +968,12 @@ export const EXTRAS_REGISTRY = {
  * @param {string[]} [config.externalSkills] - 要安装的外部 skill 名称列表
  * @param {boolean} [config.playwrightCli] - 是否安装 playwright-cli
  * @param {boolean} [config.openCli] - 是否安装 opencli
+ * @param {boolean} [config.openCliAutoDownload] - opencli 扩展缺失时是否自动下载
  * @param {string} config.projectRoot - 目标项目根目录
  * @param {boolean} config.dryRun - 是否为预览模式
  */
 export async function scaffold(config) {
-  const { platform, skills, team, pipeline, rules, aiCli, externalSkills, playwrightCli, openCli, projectRoot, dryRun } = config;
+  const { platform, skills, team, pipeline, rules, aiCli, externalSkills, playwrightCli, openCli, openCliAutoDownload, projectRoot, dryRun } = config;
   const platforms = platform === 'both' ? ['codebuddy', 'claude'] : [platform];
 
   if (dryRun) {
@@ -961,7 +1078,7 @@ export async function scaffold(config) {
   if (openCli) {
     activeExtras.push('opencli');
     console.log(chalk.blue(`    ${EXTRAS_REGISTRY['opencli'].label}:`));
-    await installOpenCli(projectRoot, dryRun);
+    await installOpenCli(projectRoot, dryRun, openCliAutoDownload);
     console.log('');
   }