prizmkit 1.1.100 → 1.1.102

package/src/platforms.js

@@ -10,6 +10,31 @@ export function expandPlatforms(platform) {
   return PLATFORM_GROUPS[platform] || LEGACY_PLATFORM_GROUPS[platform] || [platform];
 }
 
+export function platformFromAiCli(aiCli) {
+  if (!aiCli || typeof aiCli !== 'string') return null;
+  const token = aiCli.trim().split(/\s+/)[0]?.replace(/^['"]|['"]$/g, '');
+  const name = token.split(/[\\/]/).pop()?.toLowerCase() || '';
+  if (name.includes('claude')) return 'claude';
+  if (name.includes('codex')) return 'codex';
+  if (name.includes('cbc') || name.includes('codebuddy')) return 'codebuddy';
+  return null;
+}
+
+export function uniquePlatforms(platforms) {
+  return [...new Set(platforms.filter(p => PLATFORM_IDS.includes(p)))];
+}
+
+export function resolvePayloadPlatforms(platform, aiCli = '') {
+  const selected = uniquePlatforms(expandPlatforms(platform));
+  const cliPlatform = platformFromAiCli(aiCli);
+  return uniquePlatforms([...selected, cliPlatform].filter(Boolean));
+}
+
+export function payloadPlatformLabel(platform, aiCli = '') {
+  const payload = resolvePayloadPlatforms(platform, aiCli);
+  return payload.map(platformLabel).join(' + ');
+}
+
 export function isKnownPlatform(platform) {
   return PLATFORM_IDS.includes(platform) || Object.hasOwn(PLATFORM_GROUPS, platform);
 }

package/src/prompts.js

@@ -6,7 +6,6 @@
 import { select, confirm, checkbox, input } from '@inquirer/prompts';
 import chalk from 'chalk';
 import { platformLabel } from './platforms.js';
-import { normalizeRuntime } from './runtimes.js';
 
 let selectPlatformPrompt = select;
 
@@ -18,17 +17,6 @@ export function __resetSelectPlatformPromptForTests() {
   selectPlatformPrompt = select;
 }
 
-export async function selectRuntime(currentRuntime) {
-  return select({
-    message: '选择运行系统 (决定安装 macOS/Linux 或 Windows 版本的流水线与编排技能):',
-    choices: [
-      { name: 'macOS/Linux — 使用 Bash 流水线', value: 'unix' },
-      { name: 'Windows PowerShell — 使用原生 PowerShell 流水线', value: 'windows' },
-    ],
-    default: normalizeRuntime(currentRuntime),
-  });
-}
-
 /**
  * Select target platform (codebuddy, claude, codex, or all).
  * @param {string} currentPlatform - current platform value

package/src/runtimes.js

@@ -1,20 +1,27 @@
-export const RUNTIME_UNIX = 'unix';
-export const RUNTIME_WINDOWS = 'windows';
-export const RUNTIME_IDS = [RUNTIME_UNIX, RUNTIME_WINDOWS];
+export const RUNTIME_PYTHON = 'python';
+export const RUNTIME_IDS = [RUNTIME_PYTHON];
+
+export const LEGACY_UNIX_RUNTIME_ALIASES = ['unix', 'macos-linux', 'macos', 'linux'];
+export const RETIRED_WINDOWS_RUNTIME_ALIASES = ['windows', 'win', 'powershell'];
+export const LEGACY_RUNTIME_ALIASES = [
+  ...LEGACY_UNIX_RUNTIME_ALIASES,
+  ...RETIRED_WINDOWS_RUNTIME_ALIASES,
+];
 
 export function detectDefaultRuntime() {
-  return process.platform === 'win32' ? RUNTIME_WINDOWS : RUNTIME_UNIX;
+  return RUNTIME_PYTHON;
 }
 
 export function normalizeRuntime(runtime) {
-  if (!runtime || runtime === 'auto') return detectDefaultRuntime();
-  if (runtime === 'macos-linux' || runtime === 'macos' || runtime === 'linux') return RUNTIME_UNIX;
-  if (runtime === 'win' || runtime === 'powershell') return RUNTIME_WINDOWS;
-  if (RUNTIME_IDS.includes(runtime)) return runtime;
-  throw new Error(`Unknown runtime "${runtime}". Expected unix or windows.`);
+  if (!runtime) return RUNTIME_PYTHON;
+  const normalized = String(runtime).trim().toLowerCase();
+  if (!normalized || normalized === 'auto') return RUNTIME_PYTHON;
+  if (LEGACY_RUNTIME_ALIASES.includes(normalized)) return RUNTIME_PYTHON;
+  if (RUNTIME_IDS.includes(normalized)) return normalized;
+  throw new Error(`Unknown runtime "${runtime}". Expected python runtime, legacy compatibility alias, or auto.`);
 }
 
 export function runtimeLabel(runtime) {
-  const normalized = normalizeRuntime(runtime);
-  return normalized === RUNTIME_WINDOWS ? 'Windows PowerShell' : 'macOS/Linux';
+  normalizeRuntime(runtime);
+  return 'Python runtime';
 }

package/src/scaffold.js

@@ -27,8 +27,8 @@ import {
 } from './metadata.js';
 import { generateGitignore } from './gitignore-template.js';
 import { buildManifest, writeManifest } from './manifest.js';
-import { defaultCliForPlatform, expandPlatforms, isKnownPlatform, platformLabel, projectMemoryFile } from './platforms.js';
-import { normalizeRuntime, runtimeLabel, RUNTIME_UNIX, RUNTIME_WINDOWS } from './runtimes.js';
+import { defaultCliForPlatform, expandPlatforms, isKnownPlatform, platformLabel, projectMemoryFile, resolvePayloadPlatforms } from './platforms.js';
+import { normalizeRuntime, runtimeLabel } from './runtimes.js';
 
 const __scaffoldDirname = dirname(fileURLToPath(import.meta.url));
 const scaffoldPkg = JSON.parse(readFileSync(join(__scaffoldDirname, '..', 'package.json'), 'utf-8'));
@@ -50,6 +50,37 @@ const PIPELINE_MANAGED_TOP_LEVEL_PATTERNS = [
   /^README\.md$/i,
   /^SCHEMA_ANALYSIS\.md$/i,
 ];
+const RETIRED_SHELL_RUNTIME_FILES = new Set([
+  'run-feature.sh',
+  'run-bugfix.sh',
+  'run-refactor.sh',
+  'run-recovery.sh',
+  'launch-feature-daemon.sh',
+  'launch-bugfix-daemon.sh',
+  'launch-refactor-daemon.sh',
+  'reset-feature.sh',
+  'reset-bug.sh',
+  'reset-refactor.sh',
+  'lib/branch.sh',
+  'lib/common.sh',
+  'lib/heartbeat.sh',
+]);
+const RETIRED_POWERSHELL_RUNTIME_FILES = new Set([
+  'run-feature.ps1',
+  'run-bugfix.ps1',
+  'run-refactor.ps1',
+  'run-recovery.ps1',
+  'launch-feature-daemon.ps1',
+  'launch-bugfix-daemon.ps1',
+  'launch-refactor-daemon.ps1',
+  'reset-feature.ps1',
+  'reset-bug.ps1',
+  'reset-refactor.ps1',
+  'lib/common.ps1',
+  'lib/pipeline.ps1',
+  'lib/branch.ps1',
+  'lib/heartbeat.ps1',
+]);
 
 // ============================================================
 // Adapter 动态加载
@@ -101,11 +132,10 @@ export async function resolveSkillList(suite) {
   return suiteDef.skills;
 }
 
-export function resolveRuleNamesForRuntime(rulesMeta, rulesPreset = 'recommended', runtime = 'unix') {
+export function resolveRuleNamesForRuntime(rulesMeta, rulesPreset = 'recommended', runtime = 'python') {
+  normalizeRuntime(runtime);
   const preset = rulesMeta.presets[rulesPreset] || rulesMeta.presets.recommended;
-  const ruleNames = preset?.rules || [];
-  if (normalizeRuntime(runtime) !== RUNTIME_WINDOWS) return ruleNames;
-  return ruleNames.filter(name => name !== 'general/prefer-linux-commands');
+  return preset?.rules || [];
 }
 
 // ============================================================
@@ -115,7 +145,7 @@ export function resolveRuleNamesForRuntime(rulesMeta, rulesPreset = 'recommended
 /**
  * 安装 Skills（纯 Copy 模式）
  */
-export async function installSkills(platform, skills, projectRoot, dryRun, runtime = 'unix') {
+export async function installSkills(platform, skills, projectRoot, dryRun, runtime = 'python') {
   const { parseFrontmatter, buildMarkdown } = await loadSharedFrontmatter();
   
   // Load metadata to get skill -> category + subcategory mapping
@@ -435,8 +465,8 @@ export async function installTeamConfig(platform, projectRoot, dryRun) {
 /**
  * 安装平台配置文件（settings/hooks/rules）
  */
-export async function installSettings(platform, projectRoot, options, dryRun, runtime = 'unix') {
-  const normalizedRuntime = normalizeRuntime(runtime);
+export async function installSettings(platform, projectRoot, options, dryRun, runtime = 'python') {
+  normalizeRuntime(runtime);
   // 从文件加载 rules
   const rulesMeta = await loadRulesMetadata();
   const rulesPreset = options.rules || 'recommended';
@@ -464,11 +494,8 @@ export async function installSettings(platform, projectRoot, options, dryRun, ru
     await fs.ensureDir(path.dirname(settingsPath));
 
     // Read hook definition from unified template.
-    // Windows runtime intentionally omits POSIX shell hook commands.
     const templatesDir = getTemplatesDir();
-    const hookTemplate = normalizedRuntime === RUNTIME_WINDOWS
-      ? { hooks: {} }
-      : await fs.readJSON(path.join(templatesDir, 'hooks', 'commit-intent.json'));
+    const hookTemplate = await fs.readJSON(path.join(templatesDir, 'hooks', 'commit-intent.json'));
 
     await fs.writeFile(settingsPath, JSON.stringify(hookTemplate, null, 2));
     console.log(chalk.green(`      ✓ .codebuddy/settings.json`));
@@ -492,17 +519,26 @@ export async function installSettings(platform, projectRoot, options, dryRun, ru
     await fs.ensureDir(claudeDir);
 
     // Read hook definition from unified template.
-    // Windows runtime intentionally omits POSIX shell hook commands.
     const templatesDir = getTemplatesDir();
-    const hookTemplate = normalizedRuntime === RUNTIME_WINDOWS
-      ? { hooks: {} }
-      : await fs.readJSON(path.join(templatesDir, 'hooks', 'commit-intent.json'));
+    const hookTemplate = await fs.readJSON(path.join(templatesDir, 'hooks', 'commit-intent.json'));
 
     // Settings
-    const permissions = normalizedRuntime === RUNTIME_WINDOWS ? [] : [
+    const permissions = [
+      'Bash(python3 .prizmkit/dev-pipeline/cli.py *)',
+      'Bash(python .prizmkit/dev-pipeline/cli.py *)',
+      'Bash(py -3 .prizmkit/dev-pipeline/cli.py *)',
+      'Bash(python3 ./.prizmkit/dev-pipeline/cli.py *)',
+      'Bash(python ./.prizmkit/dev-pipeline/cli.py *)',
+      'Bash(py -3 ./.prizmkit/dev-pipeline/cli.py *)',
       'Bash(python3 .prizmkit/dev-pipeline/scripts/*)',
+      'Bash(python3 .prizmkit/scripts/*.py *)',
+      'Bash(python3 -c *)',
       'Bash(python .prizmkit/dev-pipeline/scripts/*)',
+      'Bash(python .prizmkit/scripts/*.py *)',
+      'Bash(python -c *)',
       'Bash(py -3 .prizmkit/dev-pipeline/scripts/*)',
+      'Bash(py -3 .prizmkit/scripts/*.py *)',
+      'Bash(py -3 -c *)',
       'Bash(git add *)',
       'Bash(git commit *)',
       'Bash(git diff *)',
@@ -510,26 +546,10 @@ export async function installSettings(platform, projectRoot, options, dryRun, ru
       'Bash(git log *)',
       'Bash(jq *)',
     ];
-    if (options.pipeline && normalizedRuntime !== RUNTIME_WINDOWS) {
-      // 动态扫描 pipeline 目录中的入口脚本，自动添加执行权限
-      const pipelineDir = getPipelineDir(runtime);
-      try {
-        const pipelineEntries = await fs.readdir(pipelineDir);
-        const entryRe = normalizedRuntime === RUNTIME_WINDOWS
-          ? /^(run-|launch-|retry-|reset-).*\.ps1$/i
-          : /^(run-|launch-|retry-|reset-).*\.sh$/;
-        const entryScripts = pipelineEntries.filter(f => entryRe.test(f));
-        for (const script of entryScripts) {
-          permissions.push(`Bash(./.prizmkit/dev-pipeline/${script} *)`);
-        }
-      } catch {
-        // Fallback: if readdir fails, add no pipeline permissions
-      }
-    }
 
     const settings = {
       permissions: { allow: permissions },
-      hooks: normalizedRuntime === RUNTIME_WINDOWS ? {} : {
+      hooks: {
         ...hookTemplate.hooks,
         SessionStart: [
           {
@@ -628,15 +648,55 @@ function buildStandalonePrizmHook(templateContent) {
   ].join('\n');
 }
 
-function buildAppendedPrizmHook(templateContent) {
+function buildShellPythonLauncherHook() {
   return [
     PRIZMKIT_HOOK_MARKER_START,
-    templateContent.trimEnd(),
+    '# PrizmKit Python validation launcher',
+    'PRIZMKIT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || PRIZMKIT_ROOT=""',
+    'if [ -n "$PRIZMKIT_ROOT" ] && [ -f "$PRIZMKIT_ROOT/.prizmkit/prizm-docs/root.prizm" ]; then',
+    '  PRIZMKIT_VALIDATE="$PRIZMKIT_ROOT/.prizmkit/scripts/validate-prizm-docs.py"',
+    '  [ -f "$PRIZMKIT_VALIDATE" ] || PRIZMKIT_VALIDATE="$PRIZMKIT_ROOT/.prizmkit/dev-pipeline/scripts/validate-prizm-docs.py"',
+    '  if [ -f "$PRIZMKIT_VALIDATE" ]; then',
+    '    if command -v python3 >/dev/null 2>&1; then',
+    '      python3 "$PRIZMKIT_VALIDATE" --staged || exit $?',
+    '    elif command -v python >/dev/null 2>&1; then',
+    '      python "$PRIZMKIT_VALIDATE" --staged || exit $?',
+    '    elif command -v py >/dev/null 2>&1; then',
+    '      py -3 "$PRIZMKIT_VALIDATE" --staged || exit $?',
+    '    else',
+    '      echo "PrizmKit: Python 3 is required for .prizm docs validation." >&2',
+    '      exit 1',
+    '    fi',
+    '  fi',
+    'fi',
     PRIZMKIT_HOOK_MARKER_END,
     '',
   ].join('\n');
 }
 
+function buildAppendedPrizmHook(templateContent, userHookContent) {
+  if (/^#!.*\bpython[0-9.]*\b/i.test(userHookContent)) {
+    return [
+      PRIZMKIT_HOOK_MARKER_START,
+      'import pathlib, subprocess, sys',
+      'prizmkit_root_result = subprocess.run(["git", "rev-parse", "--show-toplevel"], text=True, stdout=subprocess.PIPE, stderr=subprocess.DEVNULL, check=False)',
+      'if prizmkit_root_result.returncode == 0:',
+      '    prizmkit_root = pathlib.Path(prizmkit_root_result.stdout.strip())',
+      '    prizmkit_validate = prizmkit_root / ".prizmkit/scripts/validate-prizm-docs.py"',
+      '    if not prizmkit_validate.is_file():',
+      '        prizmkit_validate = prizmkit_root / ".prizmkit/dev-pipeline/scripts/validate-prizm-docs.py"',
+      '    if prizmkit_validate.is_file():',
+      '        prizmkit_result = subprocess.run([sys.executable, str(prizmkit_validate), "--staged"], cwd=prizmkit_root, check=False)',
+      '        if prizmkit_result.returncode != 0:',
+      '            raise SystemExit(prizmkit_result.returncode)',
+      PRIZMKIT_HOOK_MARKER_END,
+      '',
+    ].join('\n');
+  }
+
+  return buildShellPythonLauncherHook();
+}
+
 function insertPrizmHookIntoUserHook(userHookContent, prizmHookBlock) {
   const content = userHookContent.trimEnd();
   const terminalSuccessExitPattern = /(^|\n)([ \t]*exit[ \t]+0[ \t]*(?:#.*)?)[ \t]*$/;
@@ -724,48 +784,29 @@ function hasUserHookContent(content) {
     .length > 0;
 }
 
-export async function installGitHook(projectRoot, dryRun, runtime = 'unix') {
+export async function installGitHook(projectRoot, dryRun, runtime = 'python') {
   const gitDir = path.join(projectRoot, '.git');
-  const normalizedRuntime = normalizeRuntime(runtime);
+  normalizeRuntime(runtime);
 
   if (dryRun) {
-    const hookLabel = normalizedRuntime === RUNTIME_WINDOWS
-      ? '.git/hooks/pre-commit skipped (Windows runtime: no shell hook)'
-      : '.git/hooks/pre-commit (prizm format check)';
-    console.log(chalk.gray(`      [dry-run] ${hookLabel}`));
+    console.log(chalk.gray(`      [dry-run] .git/hooks/pre-commit (prizm format check)`));
     return;
   }
 
   if (!fs.existsSync(gitDir)) return;
 
-  const templatePath = path.join(getTemplatesDir(), 'hooks', 'prizm-pre-commit.sh');
+  const templatePath = path.join(getTemplatesDir(), 'hooks', 'prizm-pre-commit.py');
   const hooksDir = path.join(gitDir, 'hooks');
   const preCommitPath = path.join(hooksDir, 'pre-commit');
   const hookContent = fs.readFileSync(templatePath, 'utf8');
 
-  if (normalizedRuntime === RUNTIME_WINDOWS) {
-    if (fs.existsSync(preCommitPath)) {
-      const existing = fs.readFileSync(preCommitPath, 'utf8');
-      const cleaned = stripManagedPrizmHook(existing);
-      if (!hasUserHookContent(cleaned)) {
-        await fs.remove(preCommitPath);
-        console.log(chalk.gray('      • .git/hooks/pre-commit shell hook removed for Windows runtime'));
-      } else if (cleaned !== existing.trimEnd()) {
-        fs.writeFileSync(preCommitPath, ensureTrailingNewline(cleaned));
-        console.log(chalk.gray('      • PrizmKit shell hook block removed for Windows runtime'));
-      }
-    }
-    console.log(chalk.gray('      • Git hook skipped (Windows runtime uses no shell hook)'));
-    return;
-  }
-
   fs.mkdirSync(hooksDir, { recursive: true });
 
   if (fs.existsSync(preCommitPath)) {
     const existing = fs.readFileSync(preCommitPath, 'utf8');
     const cleaned = stripManagedPrizmHook(existing);
     if (hasUserHookContent(cleaned)) {
-      fs.writeFileSync(preCommitPath, insertPrizmHookIntoUserHook(cleaned, buildAppendedPrizmHook(hookContent)));
+      fs.writeFileSync(preCommitPath, insertPrizmHookIntoUserHook(cleaned, buildAppendedPrizmHook(hookContent, cleaned)));
     } else {
       fs.writeFileSync(preCommitPath, buildStandalonePrizmHook(hookContent));
     }
@@ -779,36 +820,41 @@ export async function installGitHook(projectRoot, dryRun, runtime = 'unix') {
 }
 
 /**
- * 安装 PrizmKit 脚本到 .prizmkit/scripts/（Windows runtime 跳过 shell-only 脚本）
+ * 安装 PrizmKit 脚本到 .prizmkit/scripts/
  */
-export async function installPrizmkitScripts(projectRoot, dryRun, runtime = 'unix') {
+export async function installPrizmkitScripts(projectRoot, dryRun, runtime = 'python') {
   const scriptsDir = path.join(projectRoot, '.prizmkit', 'scripts');
   const templateHooksDir = path.join(getTemplatesDir(), 'hooks');
-  const normalizedRuntime = normalizeRuntime(runtime);
+  normalizeRuntime(runtime);
 
   const scripts = [
+    'validate-prizm-docs.py',
+    'diff-prizm-docs.py',
+  ];
+  const legacyManagedScripts = [
     'validate-prizm-docs.sh',
     'diff-prizm-docs.sh',
   ];
 
   if (dryRun) {
     for (const s of scripts) {
-      const action = normalizedRuntime === RUNTIME_WINDOWS ? 'skip shell script' : `.prizmkit/scripts/${s}`;
-      console.log(chalk.gray(`      [dry-run] ${action}`));
+      console.log(chalk.gray(`      [dry-run] .prizmkit/scripts/${s}`));
     }
     return;
   }
 
-  if (normalizedRuntime === RUNTIME_WINDOWS) {
-    for (const s of scripts) {
-      await fs.remove(path.join(scriptsDir, s));
+  await fs.ensureDir(scriptsDir);
+
+  for (const legacy of legacyManagedScripts) {
+    const legacyPath = path.join(scriptsDir, legacy);
+    if (!fs.existsSync(legacyPath)) continue;
+    const legacyContent = await fs.readFile(legacyPath, 'utf8');
+    const isManagedLegacy = legacyContent.includes(`# ${legacy}`) || legacyContent.includes(`PrizmKit: ${legacy}`);
+    if (isManagedLegacy) {
+      await fs.remove(legacyPath);
     }
-    console.log(chalk.gray('      • shell-only PrizmKit scripts skipped for Windows runtime'));
-    return;
   }
 
-  await fs.ensureDir(scriptsDir);
-
   for (const s of scripts) {
     const src = path.join(templateHooksDir, s);
     if (!fs.existsSync(src)) continue;
@@ -896,10 +942,17 @@ Codex discovers repository skills from \`.agents/skills/\`. When a user or promp
  * Recursively collect all file paths under a directory.
  * Returns paths relative to `base`.
  */
+function shouldSkipRecursivePipelineEntry(entryName, relativePath) {
+  const normalized = normalizePipelineRelPath(relativePath);
+  if (normalized === '.env.example') return false;
+  return entryName.startsWith('.') || entryName === '__pycache__' || entryName === 'node_modules' || entryName.endsWith('.pyc');
+}
+
 function collectFilesRecursive(dir, base = '') {
   let files = [];
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
     const rel = path.join(base, entry.name);
+    if (shouldSkipRecursivePipelineEntry(entry.name, rel)) continue;
     if (entry.isDirectory()) {
       files.push(...collectFilesRecursive(path.join(dir, entry.name), rel));
     } else {
@@ -937,7 +990,7 @@ function collectInstallablePipelineFiles(pipelineSource) {
  * Used by upgrade to compute diff before actual installation.
  * @returns {string[]} relative file paths
  */
-export function resolvePipelineFileList(runtime = 'unix') {
+export function resolvePipelineFileList(runtime = 'python') {
   const pipelineSource = getPipelineDir(runtime);
   if (!pipelineSource || !fs.pathExistsSync(pipelineSource)) return [];
   return collectInstallablePipelineFiles(pipelineSource);
@@ -959,6 +1012,7 @@ function isLikelyManagedPipelineFile(relativeFile) {
   const normalized = normalizePipelineRelPath(relativeFile);
   const segments = normalized.split('/');
   if (segments.length === 0 || isPreservedPipelineRuntimeFile(normalized)) return false;
+  if (RETIRED_SHELL_RUNTIME_FILES.has(normalized) || RETIRED_POWERSHELL_RUNTIME_FILES.has(normalized)) return true;
   if (segments.length > 1 && PIPELINE_MANAGED_DIRS.has(segments[0])) return true;
   return PIPELINE_MANAGED_TOP_LEVEL_PATTERNS.some(pattern => pattern.test(normalized));
 }
@@ -986,7 +1040,7 @@ async function collectTargetPipelineFiles(dir, base = '') {
  * This intentionally avoids arbitrary top-level files and runtime/state
  * directories so user scratch files are preserved.
  */
-export async function findStaleManagedPipelineFiles(projectRoot, runtime = 'unix') {
+export async function findStaleManagedPipelineFiles(projectRoot, runtime = 'python') {
   const pipelineTarget = path.join(projectRoot, '.prizmkit', 'dev-pipeline');
   if (!await fs.pathExists(pipelineTarget)) return [];
 
@@ -1038,44 +1092,6 @@ export async function removeStaleManagedPipelineFiles(projectRoot, staleFiles, d
   return removedCount;
 }
 
-async function pruneStalePipelineRuntimeFiles(pipelineTarget, runtime) {
-  if (!await fs.pathExists(pipelineTarget)) return false;
-
-  const staleRuntime = runtime === RUNTIME_WINDOWS ? RUNTIME_UNIX : RUNTIME_WINDOWS;
-  const staleFiles = resolvePipelineFileList(staleRuntime);
-  const currentFiles = new Set(resolvePipelineFileList(runtime));
-  const staleDirs = new Set();
-  let prunedRuntimeSpecificFiles = false;
-
-  for (const relativeFile of staleFiles) {
-    if (currentFiles.has(relativeFile)) continue;
-
-    const targetFile = path.join(pipelineTarget, relativeFile);
-    if (await fs.pathExists(targetFile)) {
-      const stat = await fs.stat(targetFile);
-      if (stat.isFile()) {
-        await fs.remove(targetFile);
-        prunedRuntimeSpecificFiles = true;
-      }
-    }
-
-    const relativeDir = path.dirname(relativeFile);
-    if (relativeDir && relativeDir !== '.') staleDirs.add(relativeDir);
-  }
-
-  const dirsByDepth = [...staleDirs].sort((a, b) => b.split(path.sep).length - a.split(path.sep).length);
-  for (const relativeDir of dirsByDepth) {
-    const targetDir = path.join(pipelineTarget, relativeDir);
-    if (!await fs.pathExists(targetDir)) continue;
-    const entries = await fs.readdir(targetDir);
-    if (entries.length === 0) {
-      await fs.remove(targetDir);
-    }
-  }
-
-  return prunedRuntimeSpecificFiles;
-}
-
 /**
  * 安装 dev-pipeline（纯 Copy 模式）
  * 安装目标：.prizmkit/dev-pipeline/
@@ -1101,8 +1117,9 @@ export async function installPipeline(projectRoot, dryRun, options = {}) {
   await fs.ensureDir(path.join(projectRoot, '.prizmkit', 'state', 'refactor'));
 
   const runtimeSwitched = previousRuntime !== runtime;
-  const prunedStaleRuntimeFiles = await pruneStalePipelineRuntimeFiles(pipelineTarget, runtime);
-  const overwriteExisting = forceOverwrite || runtimeSwitched || prunedStaleRuntimeFiles;
+  const staleManagedFiles = await findStaleManagedPipelineFiles(projectRoot, runtime);
+  await removeStaleManagedPipelineFiles(projectRoot, staleManagedFiles, false);
+  const overwriteExisting = forceOverwrite || runtimeSwitched || staleManagedFiles.length > 0;
 
   const installedFiles = collectInstallablePipelineFiles(pipelineSource);
   let copiedCount = 0;
@@ -1399,7 +1416,7 @@ export const EXTRAS_REGISTRY = {
  * 执行纯净安装
  * @param {Object} config
  * @param {string} config.platform - 'codebuddy' | 'claude' | 'codex' | 'all'
- * @param {string} [config.runtime] - 'unix' | 'windows'
+ * @param {string} [config.runtime] - 'python' (legacy aliases accepted: 'unix' | 'windows')
  * @param {string} config.skills - 'core' | 'minimal' | 'recommended:<type>'
  * @param {boolean} config.team - 是否启用团队模式
  * @param {boolean} config.pipeline - 是否安装 dev-pipeline
@@ -1419,6 +1436,7 @@ export async function scaffold(config) {
     throw new Error(`Unknown platform "${platform}". Expected codebuddy, claude, codex, or all.`);
   }
   const platforms = expandPlatforms(platform);
+  const payloadPlatforms = resolvePayloadPlatforms(platform, aiCli);
 
   if (dryRun) {
     console.log(chalk.yellow('\n  [DRY RUN] 预览将要安装的内容:\n'));
@@ -1429,8 +1447,8 @@ export async function scaffold(config) {
 
   console.log('');
 
-  for (const p of platforms) {
-    console.log(chalk.bold(`  正在安装 ${platformLabel(p)} 环境...\n`));
+  for (const p of payloadPlatforms) {
+    console.log(chalk.bold(`  正在安装 ${platformLabel(p)} 环境...${platforms.includes(p) ? '' : chalk.gray(' (AI CLI payload)')}\n`));
 
     // 1. Skills
     console.log(chalk.blue('    技能文件:'));
@@ -1498,7 +1516,7 @@ export async function scaffold(config) {
       const skillDef = knownSkills.find(s => s.name === name);
       if (skillDef) {
         try {
-          await installExternalSkill(skillDef, platform, projectRoot, dryRun);
+          await installExternalSkill(skillDef, platform, projectRoot, dryRun, aiCli);
           console.log(chalk.green(`      ✓ ${name} (external)`));
         } catch (e) {
           console.log(chalk.yellow(`      ⚠ ${name} 安装失败，跳过: ${e.message}`));
@@ -1506,7 +1524,7 @@ export async function scaffold(config) {
       }
     }
     if (!dryRun) {
-      await cleanExternalSkillArtifacts(projectRoot, platform);
+      await cleanExternalSkillArtifacts(projectRoot, platform, aiCli);
     }
   }
 
@@ -1528,7 +1546,7 @@ export async function scaffold(config) {
   // 11. Clean up stray .codebuddy/ directory left by third-party tools (e.g. npx skills)
   // when installing for Claude Code only. CodeBuddy files should never appear in a
   // claude-only install.
-  if (!dryRun && !platforms.includes('codebuddy')) {
+  if (!dryRun && !payloadPlatforms.includes('codebuddy')) {
     const strayCbDir = path.join(projectRoot, '.codebuddy');
     if (await fs.pathExists(strayCbDir)) {
       const entries = await fs.readdir(strayCbDir);
@@ -1567,6 +1585,7 @@ export async function scaffold(config) {
       aiCli,
       rulesPreset: rulesPresetName,
       extras: activeExtras,
+      payloadPlatforms,
     });
     await writeManifest(projectRoot, manifest);
     console.log(chalk.green('      ✓ .prizmkit/manifest.json'));
@@ -1615,7 +1634,10 @@ export async function scaffold(config) {
     console.log(chalk.gray(`  安装统计:`));
     console.log(chalk.gray(`    技能: ${suiteLabel}`));
     console.log(chalk.gray(`    平台: ${platforms.map(platformLabel).join(' + ')}`));
-    console.log(chalk.gray(`    运行系统: ${runtimeLabel(runtime)}`));
+    if (payloadPlatforms.length !== platforms.length || payloadPlatforms.some(p => !platforms.includes(p))) {
+      console.log(chalk.gray(`    AI CLI 载荷平台: ${payloadPlatforms.map(platformLabel).join(' + ')}`));
+    }
+    console.log(chalk.gray(`    运行时: ${runtimeLabel(runtime)}`));
     console.log(chalk.gray(`    团队: ${team ? '已启用' : '未启用'}`));
     console.log(chalk.gray(`    流水线: ${pipeline ? '已安装' : '未安装'}`));
     const browserTools = [playwrightCli && 'playwright-cli', openCli && 'opencli'].filter(Boolean);

package/src/upgrade.js

@@ -27,6 +27,7 @@ import {
   installGitHook,
   installGitignore,
   installProjectMemory,
+  installTeamConfig,
   resolvePipelineFileList,
   findStaleManagedPipelineFiles,
   removeStaleManagedPipelineFiles,
@@ -34,7 +35,7 @@ import {
   resolveSkillList,
   EXTRAS_REGISTRY,
 } from './scaffold.js';
-import { expandPlatforms, platformLabel } from './platforms.js';
+import { platformLabel, resolvePayloadPlatforms } from './platforms.js';
 import { normalizeRuntime, runtimeLabel } from './runtimes.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -220,7 +221,7 @@ export async function runUpgrade(directory, options = {}) {
 
   // 3. Resolve new skill list using old manifest's suite + platform (or defaults)
   const suite = oldManifest?.suite || 'core';
-  const runtime = normalizeRuntime(oldManifest?.runtime || 'unix');
+  const runtime = normalizeRuntime(oldManifest?.runtime);
   const team = oldManifest?.options?.team ?? true;
   const pipeline = oldManifest?.options?.pipeline ?? true;
   const rulesPreset = oldManifest?.options?.rules || 'recommended';
@@ -276,6 +277,8 @@ export async function runUpgrade(directory, options = {}) {
     ...(!oldManifest?.files?.extras ? Object.keys(EXTRAS_REGISTRY) : []),
   ])].filter(name => EXTRAS_REGISTRY[name]);  // only keep extras that still exist in registry
 
+  const payloadPlatforms = resolvePayloadPlatforms(platform, aiCli);
+
   // 4. Build new manifest and compute diff
   const newManifest = buildManifest({
     version: pkg.version,
@@ -290,6 +293,7 @@ export async function runUpgrade(directory, options = {}) {
     aiCli,
     rulesPreset,
     extras: extrasToInstall,
+    payloadPlatforms,
   });
 
   // Preserve original installedAt
@@ -349,7 +353,7 @@ export async function runUpgrade(directory, options = {}) {
   }
 
   // 7. Execute
-  const platforms = expandPlatforms(platform);
+  const platforms = payloadPlatforms;
 
   // 7a. Remove orphaned files
   if (diff.skills.removed.length || diff.agents.removed.length || diff.rules.removed.length || diff.pipeline.removed.length || staleManagedPipelineFiles.length) {
@@ -396,6 +400,11 @@ export async function runUpgrade(directory, options = {}) {
     console.log(chalk.blue('\n    Settings & Rules:'));
     await installSettings(p, projectRoot, { pipeline, rules: rulesPreset }, dryRun, runtime);
 
+    if (team) {
+      console.log(chalk.blue('\n    Team Config:'));
+      await installTeamConfig(p, projectRoot, dryRun);
+    }
+
     console.log('');
   }