prizmkit 1.1.19 → 1.1.21

package/bundled/dev-pipeline/templates/bootstrap-tier3.md

@@ -364,17 +364,32 @@ You MUST execute this phase. Do NOT skip it. Do NOT mark it as completed without
 You know this project's tech stack. Detect and start the dev server yourself:
 
 1. Identify the dev server start command from project config (`package.json` scripts, `Makefile`, `docker-compose.yml`, etc.)
-2. Choose an available port — check what the project defaults to, or pick one that is free:
+2. **Detect the dev server port** — use the pre-detected port from pipeline if available, otherwise extract from project config. Do NOT hardcode or guess the port:
    ```bash
-   lsof -ti:<port> 2>/dev/null && echo "PORT_IN_USE" || echo "PORT_FREE"
+   # Use pipeline-injected port if available, otherwise extract from package.json
+   DEV_PORT={{DEV_PORT}}
+   # If DEV_PORT is still a placeholder, detect at runtime:
+   if [ "$DEV_PORT" = "{{DEV_PORT}}" ]; then
+     DEV_PORT=$(node -e "const s=require('./package.json').scripts.dev; const m=s.match(/-p\s+(\d+)/); console.log(m?m[1]:'')")
+     if [ -z "$DEV_PORT" ]; then
+       DEV_PORT=$(echo "$NEXT_PUBLIC_SITE_URL" | sed -nE 's|.*:([0-9]+).*|\1|p')
+     fi
+     DEV_PORT=${DEV_PORT:-3000}
+   fi
+   echo "Detected DEV_PORT=$DEV_PORT"
    ```
-3. Start the dev server in background, capture PID:
+3. Verify the port is available:
+   ```bash
+   lsof -ti:$DEV_PORT 2>/dev/null && echo "PORT_IN_USE" || echo "PORT_FREE"
+   ```
+4. Start the dev server in background, capture PID:
    ```bash
    <start-command> &
    DEV_SERVER_PID=$!
    ```
-4. Wait for server to be ready: poll the target URL with `curl -s -o /dev/null -w "%{http_code}"` until it returns 200 or 302 (max 30 seconds, 2s interval)
-5. If the page requires authentication, use playwright-cli to register a test user and log in first
+5. Wait for server to be ready: poll `http://localhost:$DEV_PORT` with `curl -s -o /dev/null -w "%{http_code}"` until it returns 200 or 302 (max 30 seconds, 2s interval)
+6. Open the app in playwright-cli: `playwright-cli open http://localhost:$DEV_PORT`
+7. If the page requires authentication, use playwright-cli to register a test user and log in first
 
 **Step 2 — Verification**:
 
@@ -387,14 +402,14 @@ Take a final screenshot for evidence.
 **Step 3 — Cleanup (REQUIRED — you started it, you stop it)**:
 
 1. Kill the dev server process: `kill $DEV_SERVER_PID 2>/dev/null || true`
-2. Verify port is released: `lsof -ti:<port> | xargs kill -9 2>/dev/null || true`
+2. Verify port is released: `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
 
 **Step 4 — Reporting**:
 
 Append results to `context-snapshot.md`:
    ```
    ## Browser Verification
-   URL: <actual URL used>
+   URL: http://localhost:$DEV_PORT
    Dev Server Command: <actual command used>
    Steps executed: [list]
    Screenshot: [path]

package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md

@@ -7,17 +7,32 @@ You MUST execute this phase. Do NOT skip it. Do NOT mark it as completed without
 You know this project's tech stack. Detect and start the dev server yourself:
 
 1. Identify the dev server start command from project config (`package.json` scripts, `Makefile`, `docker-compose.yml`, etc.)
-2. Choose an available port — check what the project defaults to, or pick one that is free:
+2. **Detect the dev server port** — use the pre-detected port from pipeline if available, otherwise extract from project config. Do NOT hardcode or guess the port:
    ```bash
-   lsof -ti:<port> 2>/dev/null && echo "PORT_IN_USE" || echo "PORT_FREE"
+   # Use pipeline-injected port if available, otherwise extract from package.json
+   DEV_PORT={{DEV_PORT}}
+   # If DEV_PORT is still a placeholder, detect at runtime:
+   if [ "$DEV_PORT" = "{{DEV_PORT}}" ]; then
+     DEV_PORT=$(node -e "const s=require('./package.json').scripts.dev; const m=s.match(/-p\s+(\d+)/); console.log(m?m[1]:'')")
+     if [ -z "$DEV_PORT" ]; then
+       DEV_PORT=$(echo "$NEXT_PUBLIC_SITE_URL" | sed -nE 's|.*:([0-9]+).*|\1|p')
+     fi
+     DEV_PORT=${DEV_PORT:-3000}
+   fi
+   echo "Detected DEV_PORT=$DEV_PORT"
    ```
-3. Start the dev server in background, capture PID:
+3. Verify the port is available:
+   ```bash
+   lsof -ti:$DEV_PORT 2>/dev/null && echo "PORT_IN_USE" || echo "PORT_FREE"
+   ```
+4. Start the dev server in background, capture PID:
    ```bash
    <start-command> &
    DEV_SERVER_PID=$!
    ```
-4. Wait for server to be ready: poll the target URL with `curl -s -o /dev/null -w "%{http_code}"` until it returns 200 or 302 (max 30 seconds, 2s interval)
-5. If the page requires authentication, use playwright-cli to register a test user and log in first
+5. Wait for server to be ready: poll `http://localhost:$DEV_PORT` with `curl -s -o /dev/null -w "%{http_code}"` until it returns 200 or 302 (max 30 seconds, 2s interval)
+6. Open the app in playwright-cli: `playwright-cli open http://localhost:$DEV_PORT`
+7. If the page requires authentication, use playwright-cli to register a test user and log in first
 
 **Step 2 — Verification**:
 
@@ -31,14 +46,14 @@ Take a final screenshot for evidence.
 **Step 3 — Cleanup (REQUIRED — you started it, you stop it)**:
 
 1. Kill the dev server process: `kill $DEV_SERVER_PID 2>/dev/null || true`
-2. Verify port is released: `lsof -ti:<port> | xargs kill -9 2>/dev/null || true`
+2. Verify port is released: `lsof -ti:$DEV_PORT | xargs kill -9 2>/dev/null || true`
 
 **Step 4 — Reporting**:
 
 Append results to `context-snapshot.md`:
 ```
 ## Browser Verification
-URL: <actual URL used>
+URL: http://localhost:$DEV_PORT
 Dev Server Command: <actual command used>
 Steps executed: [list]
 Screenshot: [path]

package/bundled/skills/_metadata.json

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

package/src/config.js

@@ -79,6 +79,65 @@ function expandPlatforms(platform) {
   return platform === 'both' ? ['codebuddy', 'claude'] : [platform];
 }
 
+function getProjectMemoryFile(platform) {
+  if (platform === 'claude') return 'CLAUDE.md';
+  if (platform === 'codebuddy') return 'CODEBUDDY.md';
+  return null;
+}
+
+function getCounterpartPlatform(platform) {
+  return platform === 'claude' ? 'codebuddy' : platform === 'codebuddy' ? 'claude' : null;
+}
+
+async function migrateProjectMemoryOnPlatformDrop(droppedPlatform, newPlatforms, projectRoot, dryRun) {
+  const sourceFile = getProjectMemoryFile(droppedPlatform);
+  if (!sourceFile) return;
+
+  const sourcePath = path.join(projectRoot, sourceFile);
+  if (!await fs.pathExists(sourcePath)) return;
+
+  const counterpart = getCounterpartPlatform(droppedPlatform);
+  const targetPlatform = (counterpart && newPlatforms.includes(counterpart))
+    ? counterpart
+    : newPlatforms.find(p => p !== droppedPlatform);
+
+  if (!targetPlatform || targetPlatform === droppedPlatform) return;
+
+  const targetFile = getProjectMemoryFile(targetPlatform);
+  if (!targetFile || targetFile === sourceFile) return;
+
+  const targetPath = path.join(projectRoot, targetFile);
+
+  if (dryRun) {
+    console.log(chalk.gray(`      [dry-run] migrate ${sourceFile} -> ${targetFile}`));
+    return;
+  }
+
+  const sourceContent = await fs.readFile(sourcePath, 'utf-8');
+  if (!sourceContent.trim()) return;
+
+  if (!await fs.pathExists(targetPath)) {
+    const normalized = sourceContent.endsWith('\n') ? sourceContent : `${sourceContent}\n`;
+    await fs.writeFile(targetPath, normalized, 'utf-8');
+    console.log(chalk.green(`      ✓ migrated ${sourceFile} -> ${targetFile}`));
+    return;
+  }
+
+  const targetContent = await fs.readFile(targetPath, 'utf-8');
+  const normalizedSource = sourceContent.replace(/\r\n/g, '\n').trim();
+  const normalizedTarget = targetContent.replace(/\r\n/g, '\n').trim();
+
+  if (!normalizedSource || normalizedTarget.includes(normalizedSource)) {
+    console.log(chalk.gray(`      • ${targetFile} already contains ${sourceFile} content, skip merge`));
+    return;
+  }
+
+  const separator = targetContent.endsWith('\n') ? '\n' : '\n\n';
+  const merged = `${targetContent}${separator}<!-- MIGRATED FROM ${sourceFile} via prizmkit config -->\n\n${sourceContent.trimEnd()}\n`;
+  await fs.writeFile(targetPath, merged, 'utf-8');
+  console.log(chalk.green(`      ✓ merged ${sourceFile} content into ${targetFile}`));
+}
+
 const platformLabel = (p) => p === 'both' ? 'CodeBuddy + Claude Code'
   : p === 'codebuddy' ? 'CodeBuddy' : 'Claude Code';
 
@@ -364,13 +423,18 @@ export async function runConfig(directory, options = {}) {
   const newRuleFiles = (rulesPresetDef?.rules || []).map(name => `${name}.md`);
   const newPipelineFiles = newConfig.pipeline ? resolvePipelineFileList() : [];
 
-  // 5a. Remove files for platforms being dropped
+  // 5a. Migrate project memory before removing dropped platforms
+  for (const p of platformsToRemove) {
+    await migrateProjectMemoryOnPlatformDrop(p, newPlatforms, projectRoot, false);
+  }
+
+  // 5b. Remove files for platforms being dropped
   for (const p of platformsToRemove) {
     console.log(chalk.bold(`  移除 ${platformLabel(p)} 平台文件...`));
     await removePlatformFiles(p, projectRoot, oldManifest, false);
   }
 
-  // 5b. Handle skill/rule diff for existing platforms (suite or rules changed)
+  // 5c. Handle skill/rule diff for existing platforms (suite or rules changed)
   if (newConfig.suite !== currentConfig.suite || newConfig.rules !== currentConfig.rules) {
     const newTempManifest = buildManifest({
       version: pkg.version, platform: newConfig.platform, suite: newConfig.suite,
@@ -393,7 +457,7 @@ export async function runConfig(directory, options = {}) {
     }
   }
 
-  // 5c. Install/update files for new + existing platforms
+  // 5d. Install/update files for new + existing platforms
   const allTargetPlatforms = [...platformsToAdd, ...platformsToUpdate];
   const needsReinstall = newConfig.platform !== currentConfig.platform
     || newConfig.suite !== currentConfig.suite
@@ -427,7 +491,7 @@ export async function runConfig(directory, options = {}) {
     }
   }
 
-  // 5d. Pipeline changes
+  // 5e. Pipeline changes
   if (newConfig.pipeline !== currentConfig.pipeline) {
     if (newConfig.pipeline) {
       console.log(chalk.blue('\n    安装 Pipeline:'));
@@ -441,11 +505,11 @@ export async function runConfig(directory, options = {}) {
     }
   }
 
-  // 5e. Update .gitignore
+  // 5f. Update .gitignore
   console.log(chalk.blue('\n    Gitignore:'));
   await installGitignore(projectRoot, { pipeline: newConfig.pipeline }, false);
 
-  // 5f. Update .prizmkit/config.json (ai_cli)
+  // 5g. Update .prizmkit/config.json (ai_cli)
   if (newConfig.aiCli !== currentConfig.aiCli) {
     const prizmkitDir = path.join(projectRoot, '.prizmkit');
     await fs.ensureDir(prizmkitDir);
@@ -462,7 +526,7 @@ export async function runConfig(directory, options = {}) {
     console.log(chalk.green(`\n      ✓ .prizmkit/config.json (ai_cli: ${newConfig.aiCli || '(cleared)'})`));
   }
 
-  // 5g. Write new manifest
+  // 5h. Write new manifest
   const newManifest = buildManifest({
     version: pkg.version,
     platform: newConfig.platform,