prizmkit 1.0.136 → 1.0.137

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.136",
-  "bundledAt": "2026-03-28T13:29:14.147Z",
-  "bundledFrom": "0e6a37f"
+  "frameworkVersion": "1.0.137",
+  "bundledAt": "2026-03-28T13:49:17.127Z",
+  "bundledFrom": "1cfc8e2"
 }

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.136",
+  "version": "1.0.137",
   "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.0.136",
+  "version": "1.0.137",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {

package/src/manifest.js

@@ -55,6 +55,7 @@ export async function writeManifest(projectRoot, data) {
  * @param {boolean} params.team - whether team config was installed
  * @param {string} [params.aiCli] - AI CLI command
  * @param {string} [params.rulesPreset] - rules preset name
+ * @param {string[]} [params.extras] - installed extras (e.g. ['playwright-cli'])
  * @returns {Object} manifest
  */
 export function buildManifest({
@@ -68,6 +69,7 @@ export function buildManifest({
   team,
   aiCli,
   rulesPreset,
+  extras,
 }) {
   const now = new Date().toISOString();
   return {
@@ -87,6 +89,7 @@ export function buildManifest({
       agents: [...agents],
       rules: [...rules],
       pipeline: pipeline ? [...pipeline] : [],
+      extras: extras ? [...extras] : [],
       other: [platform === 'claude' ? 'CLAUDE.md' : platform === 'codebuddy' ? 'CODEBUDDY.md' : 'CLAUDE.md'],
     },
   };

package/src/scaffold.js

@@ -676,6 +676,7 @@ export async function installPipeline(projectRoot, dryRun, { forceOverwrite = fa
  */
 export async function installGitignore(projectRoot, options, dryRun) {
   const targetPath = path.join(projectRoot, '.gitignore');
+  const templateContent = generateGitignore({ pipeline: options.pipeline });
 
   if (dryRun) {
     console.log(chalk.gray(`      [dry-run] .gitignore`));
@@ -683,12 +684,22 @@ export async function installGitignore(projectRoot, options, dryRun) {
   }
 
   if (await fs.pathExists(targetPath)) {
-    console.log(chalk.yellow(`      ⚠ .gitignore 已存在，跳过`));
-    return;
+    // 合并模式：追加缺失条目
+    const existing = await fs.readFile(targetPath, 'utf-8');
+    const existingLines = new Set(existing.split('\n').map(l => l.trim()));
+    const templateLines = templateContent.split('\n').map(l => l.trim()).filter(Boolean);
+    const missing = templateLines.filter(line => !existingLines.has(line) && !line.startsWith('#'));
+
+    if (missing.length > 0) {
+      const separator = existing.endsWith('\n') ? '' : '\n';
+      await fs.appendFile(targetPath, separator + '\n# PrizmKit\n' + missing.join('\n') + '\n');
+      console.log(chalk.green(`      ✓ .gitignore (added ${missing.length} entries)`));
+    } else {
+      console.log(chalk.green('      ✓ .gitignore (up-to-date)'));
+    }
   } else {
-    const content = generateGitignore({ pipeline: options.pipeline });
-    await fs.writeFile(targetPath, content);
-    console.log(chalk.green(`      ✓ .gitignore`));
+    await fs.writeFile(targetPath, templateContent);
+    console.log(chalk.green('      ✓ .gitignore'));
   }
 }
 
@@ -733,6 +744,21 @@ export async function installPlaywrightCli(projectRoot, dryRun) {
   }
 }
 
+// ============================================================
+// Extras 注册表
+// ============================================================
+
+/**
+ * 外部工具注册表。upgrade.js 遍历此表来安装/更新外部工具。
+ * 新增工具只需：1) 写 installXxx 函数  2) 加一行到此表
+ */
+export const EXTRAS_REGISTRY = {
+  'playwright-cli': {
+    label: '浏览器交互工具',
+    install: installPlaywrightCli,
+  },
+};
+
 // ============================================================
 // 主安装函数
 // ============================================================
@@ -846,9 +872,11 @@ export async function scaffold(config) {
     }
   }
 
-  // 10. Playwright CLI (optional)
+  // 10. Extras (external tools via registry)
+  const activeExtras = [];
   if (playwrightCli) {
-    console.log(chalk.blue('    浏览器交互工具:'));
+    activeExtras.push('playwright-cli');
+    console.log(chalk.blue(`    ${EXTRAS_REGISTRY['playwright-cli'].label}:`));
     await installPlaywrightCli(projectRoot, dryRun);
     console.log('');
   }
@@ -894,6 +922,7 @@ export async function scaffold(config) {
       team,
       aiCli,
       rulesPreset: rulesPresetName,
+      extras: activeExtras,
     });
     await writeManifest(projectRoot, manifest);
     console.log(chalk.green('      ✓ .prizmkit/manifest.json'));

package/src/upgrade.js

@@ -30,6 +30,7 @@ import {
   installGitignore,
   installProjectMemory,
   resolvePipelineFileList,
+  EXTRAS_REGISTRY,
 } from './scaffold.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -244,6 +245,13 @@ export async function runUpgrade(directory, options = {}) {
   // Resolve pipeline file list from source (for manifest diff)
   const newPipelineFiles = pipeline ? resolvePipelineFileList() : [];
 
+  // Resolve extras: merge old manifest extras + default extras for old manifests without the field
+  const extrasToInstall = [...new Set([
+    ...(oldManifest?.files?.extras || []),
+    // Old manifests without extras field: default to all registered extras
+    ...(!oldManifest?.files?.extras ? Object.keys(EXTRAS_REGISTRY) : []),
+  ])].filter(name => EXTRAS_REGISTRY[name]);  // only keep extras that still exist in registry
+
   // 4. Build new manifest and compute diff
   const newManifest = buildManifest({
     version: pkg.version,
@@ -256,6 +264,7 @@ export async function runUpgrade(directory, options = {}) {
     team,
     aiCli,
     rulesPreset,
+    extras: extrasToInstall,
   });
 
   // Preserve original installedAt
@@ -360,6 +369,17 @@ export async function runUpgrade(directory, options = {}) {
     console.log('');
   }
 
+  // Extras (external tools via registry)
+  if (extrasToInstall.length > 0) {
+    for (const extraName of extrasToInstall) {
+      const entry = EXTRAS_REGISTRY[extraName];
+      if (!entry) continue;
+      console.log(chalk.blue(`    ${entry.label}:`));
+      await entry.install(projectRoot, dryRun);
+      console.log('');
+    }
+  }
+
   // Git hook
   console.log(chalk.blue('    Git Hook:'));
   await installGitHook(projectRoot, dryRun);