prizmkit 1.1.99 → 1.1.101

package/bundled/templates/hooks/validate-prizm-docs.py

@@ -0,0 +1,240 @@
+#!/usr/bin/env python3
+"""Validate .prizmkit/prizm-docs files for PrizmKit projects."""
+
+from __future__ import annotations
+
+import re
+import subprocess
+import sys
+from pathlib import Path, PurePosixPath
+
+DOCS_ROOT = Path(".prizmkit/prizm-docs")
+ROOT_PRIZM = DOCS_ROOT / "root.prizm"
+VALID_MODES = {"--all", "--staged"}
+
+AUXILIARY_METADATA_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(CHANGELOG|CREATED([ _-]?(AT|ON|DATE))?|"
+    r"UPDATED([ _-]?(AT|ON|DATE))?|MODIFIED([ _-]?(AT|ON|DATE))?|"
+    r"LAST[ _-]?(UPDATED|MODIFIED)([ _-]?(AT|ON|DATE))?|DATE|TIMESTAMP):",
+    re.IGNORECASE | re.MULTILINE,
+)
+WORKFLOW_ID_RE = re.compile(
+    r"(^|[^A-Za-z0-9_])([FBR]-[0-9]{3}|T-[0-9]{3})(-[A-Z])?([^A-Za-z0-9_]|$)",
+    re.IGNORECASE,
+)
+WORKFLOW_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*((bug|feature|refactor|task)[ _-]?id|"
+    r"(session|run|pipeline|workflow)([ _-]?id)?)([ \t]*(:|=)|[ \t]+)",
+    re.IGNORECASE | re.MULTILINE,
+)
+WORKFLOW_COMPOUND_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(bug|feature|refactor|task|session|run|pipeline|workflow)"
+    r"([ _-](bug|feature|refactor|task|session|run|pipeline|workflow|id))+"
+    r"([ \t]*(:|=)|[ \t]+)",
+    re.IGNORECASE | re.MULTILINE,
+)
+ARTIFACT_PATH_RE = re.compile(
+    r"(^|[^A-Za-z0-9_.-])\.prizmkit/(specs|dev-pipeline)($|/|[^A-Za-z0-9_.-])"
+)
+ABSOLUTE_PATH_RE = re.compile(
+    r"(^|[^A-Za-z0-9_./:-])"
+    r"(/Users/|/home/|/tmp/|/private/tmp/|/var/folders/|/workspace/|/workspaces/|"
+    r"/opt/|/srv/|/root/|/var/tmp/|/Volumes/|/mnt/[A-Za-z]/|[A-Za-z]:/)"
+)
+BRANCH_EXACT_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(BRANCH|BRANCH_NAME|CURRENT_BRANCH|SOURCE_BRANCH|BASE_BRANCH|"
+    r"HEAD_BRANCH|GIT_BRANCH|TARGET_BRANCH)[ \t_-]*(:|=|[ \t])",
+    re.MULTILINE,
+)
+BRANCH_UPPER_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*[A-Z][A-Z0-9_]*_BRANCH[ \t_-]*(:|=|[ \t])"
+    r"[ \t]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|"
+    r"(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)"
+    r"[ \t]*(#.*)?$",
+    re.MULTILINE,
+)
+BRANCH_NAME_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(branch[ _-]*name|current[ _-]*branch|source[ _-]*branch|"
+    r"base[ _-]*branch|head[ _-]*branch|git[ _-]*branch|target[ _-]*branch)"
+    r"[ \t_-]*(:|=|[ \t])",
+    re.IGNORECASE | re.MULTILINE,
+)
+BRANCH_TITLE_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*([A-Za-z0-9]+[ _-]+)+branch([ \t]*(:|=)|[ \t]+)"
+    r"[ \t]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|"
+    r"(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)"
+    r"[ \t]*(#.*)?$",
+    re.IGNORECASE | re.MULTILINE,
+)
+BRANCH_SIMPLE_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*branch[ \t_-]*(:|=|[ \t])"
+    r"[ \t]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|"
+    r"(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)"
+    r"[ \t]*(#.*)?$",
+    re.IGNORECASE | re.MULTILINE,
+)
+
+
+def emit_error(file_path: str, message: str) -> None:
+    print(f"ERROR: {file_path} {message}", file=sys.stderr)
+
+
+def run_git(args: list[str], *, capture: bool = True) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        ["git", *args],
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+        stdout=subprocess.PIPE if capture else subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        check=False,
+    )
+
+
+def collect_files(mode: str) -> list[str]:
+    if mode == "--all":
+        return sorted(path.as_posix() for path in DOCS_ROOT.rglob("*.prizm") if path.is_file())
+
+    result = run_git(["diff", "--cached", "--name-only"])
+    if result.returncode != 0:
+        return []
+    return [line.strip() for line in result.stdout.splitlines() if line.strip().endswith(".prizm")]
+
+
+def read_check_content(file_path: str, mode: str) -> tuple[bytes, str] | None:
+    if mode == "--staged":
+        exists = run_git(["cat-file", "-e", f":{file_path}"], capture=False)
+        if exists.returncode != 0:
+            return None
+        blob = subprocess.run(
+            ["git", "show", f":{file_path}"],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.DEVNULL,
+            check=False,
+        )
+        if blob.returncode != 0:
+            return None
+        raw = blob.stdout
+    else:
+        path = Path(file_path)
+        if not path.is_file():
+            return None
+        raw = path.read_bytes()
+
+    return raw, raw.decode("utf-8", errors="replace")
+
+
+def is_l1_doc(file_path: str) -> bool:
+    parent = PurePosixPath(file_path).parent.as_posix()
+    return parent == DOCS_ROOT.as_posix()
+
+
+def size_limit(file_path: str) -> tuple[int, str, str]:
+    if file_path.endswith("root.prizm"):
+        return 4096, "L0", "Consolidate MODULE_INDEX, keep top-5 RULES."
+    if is_l1_doc(file_path):
+        return 3072, "L1", "Move implementation details to L2."
+    return 5120, "L2", "Remove stale or trivially derivable entries."
+
+
+def contains_root_field(text: str, field: str) -> bool:
+    return re.search(rf"^{re.escape(field)}:", text, re.MULTILINE) is not None
+
+
+def validate_file(file_path: str, raw: bytes, text: str) -> int:
+    errors = 0
+
+    if re.search(r"^#{1,6} ", text, re.MULTILINE):
+        emit_error(file_path, "contains markdown headers (##). Use KEY: value format.")
+        errors += 1
+
+    if re.search(r"^```", text, re.MULTILINE):
+        emit_error(file_path, "contains code blocks. Use file_path:line_number reference.")
+        errors += 1
+
+    base_name = PurePosixPath(file_path).name.lower()
+    if base_name in {"changelog.prizm", "changelog-archive.prizm"} or (
+        "changelog" in base_name and base_name.endswith(".prizm")
+    ):
+        emit_error(file_path, "is auxiliary history. Use git history instead of changelog .prizm files.")
+        errors += 1
+
+    if AUXILIARY_METADATA_RE.search(text):
+        emit_error(
+            file_path,
+            "contains auxiliary history metadata. Use durable KEY: value sections only; git tracks history.",
+        )
+        errors += 1
+
+    if WORKFLOW_ID_RE.search(text) or WORKFLOW_FIELD_RE.search(text) or WORKFLOW_COMPOUND_FIELD_RE.search(text):
+        emit_error(
+            file_path,
+            "contains workflow metadata. Translate IDs, branch names, worktree paths, and pipeline artifacts into durable product/domain language.",
+        )
+        errors += 1
+
+    normalized_text = text.replace("\\", "/")
+    if ARTIFACT_PATH_RE.search(normalized_text):
+        emit_error(
+            file_path,
+            "contains PrizmKit artifact paths. Translate specs/dev-pipeline references into durable product/domain language.",
+        )
+        errors += 1
+
+    if ABSOLUTE_PATH_RE.search(normalized_text):
+        emit_error(file_path, "contains absolute worktree paths. Use repository-relative source paths only.")
+        errors += 1
+
+    if (
+        BRANCH_EXACT_FIELD_RE.search(text)
+        or BRANCH_UPPER_FIELD_RE.search(text)
+        or BRANCH_NAME_FIELD_RE.search(text)
+        or BRANCH_TITLE_FIELD_RE.search(text)
+        or BRANCH_SIMPLE_FIELD_RE.search(text)
+    ):
+        emit_error(file_path, "contains branch names. Describe durable product/domain context instead.")
+        errors += 1
+
+    limit, level, hint = size_limit(file_path)
+    size = len(raw)
+    if size > limit:
+        emit_error(file_path, f"exceeds {level} limit ({size}B > {limit}B). {hint}")
+        errors += 1
+
+    if file_path.endswith("root.prizm"):
+        for field in ["PRIZM_VERSION", "PROJECT", "LANG", "RULES"]:
+            if not contains_root_field(text, field):
+                emit_error(file_path, f"missing required field {field}:")
+                errors += 1
+        if not contains_root_field(text, "MODULE_INDEX") and not contains_root_field(text, "MODULE_GROUPS"):
+            emit_error(file_path, "missing required field MODULE_INDEX: or MODULE_GROUPS:")
+            errors += 1
+
+    return errors
+
+
+def main(argv: list[str]) -> int:
+    mode = argv[1] if len(argv) > 1 else "--staged"
+    if len(argv) > 2 or mode not in VALID_MODES:
+        print("Usage: validate-prizm-docs.py [--all | --staged]", file=sys.stderr)
+        return 1
+
+    if not ROOT_PRIZM.is_file():
+        return 0
+
+    errors = 0
+    for file_path in collect_files(mode):
+        content = read_check_content(file_path, mode)
+        if content is None:
+            continue
+        raw, text = content
+        errors += validate_file(file_path, raw, text)
+
+    if errors > 0:
+        print(f"PrizmKit: {errors} format error(s) in .prizm files. Fix before committing.", file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.1.99",
+  "version": "1.1.101",
   "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

@@ -36,6 +36,8 @@ import {
   resolveSkillList,
   resolvePipelineFileList,
   resolveRuleNamesForRuntime,
+  findStaleManagedPipelineFiles,
+  removeStaleManagedPipelineFiles,
 } from './scaffold.js';
 import {
   removeSkillFiles,
@@ -47,7 +49,6 @@ import { detectPlatform } from './detect-platform.js';
 import {
   selectPlatform,
   selectAiCli,
-  selectRuntime,
   selectSkillSuite,
   selectRulesPreset,
   confirmTeamMode,
@@ -350,11 +351,17 @@ export async function runConfig(directory, options = {}) {
 
   // Existing manifests are the source of truth. Filesystem detection is only a
   // legacy fallback for manifests created before platform was recorded.
-  const detectedPlatform = oldManifest.platform || await detectInstalledPlatforms(projectRoot) || 'claude';
+  const detectedPlatformRaw = oldManifest.platform || await detectInstalledPlatforms(projectRoot) || 'claude';
+  const detectedPlatform = detectedPlatformRaw === 'both' ? 'all' : detectedPlatformRaw;
+
+  const rawManifestRuntime = oldManifest.runtime;
+  const normalizedManifestRuntime = normalizeRuntime(rawManifestRuntime);
+  const runtimeManifestNeedsNormalization = rawManifestRuntime !== normalizedManifestRuntime;
+  const platformManifestNeedsNormalization = detectedPlatformRaw !== detectedPlatform;
 
   const currentConfig = {
     platform: detectedPlatform,
-    runtime: normalizeRuntime(oldManifest.runtime || 'unix'),
+    runtime: normalizedManifestRuntime,
     suite: oldManifest.suite || 'core',
     rules: oldManifest.options?.rules || 'recommended',
     team: oldManifest.options?.team ?? true,
@@ -369,7 +376,7 @@ export async function runConfig(directory, options = {}) {
   // Display current config
   console.log(chalk.bold('  当前配置:'));
   console.log(`    平台:     ${chalk.cyan(platformLabel(currentConfig.platform))}`);
-  console.log(`    运行系统: ${chalk.cyan(runtimeLabel(currentConfig.runtime))}`);
+  console.log(`    运行时:   ${chalk.cyan(runtimeLabel(currentConfig.runtime))}`);
   console.log(`    AI CLI:   ${currentConfig.aiCli ? chalk.cyan(currentConfig.aiCli) : chalk.gray('(未设置)')}`);
   console.log(`    技能套件: ${chalk.cyan(currentConfig.suite)}`);
   console.log(`    规则:     ${chalk.cyan(currentConfig.rules)}`);
@@ -381,10 +388,11 @@ export async function runConfig(directory, options = {}) {
 
   let newConfig;
   const optionRuntime = options.runtime !== undefined ? normalizeRuntime(options.runtime) : undefined;
+  const runtimeOptionNeedsNormalization = options.runtime !== undefined && options.runtime !== optionRuntime;
 
   if (nonInteractive) {
     // Non-interactive: only change what's explicitly specified via CLI options
-    if (!options.platform && !options.skills && !options.rules && options.runtime === undefined
+    if (!platformManifestNeedsNormalization && !runtimeManifestNeedsNormalization && !runtimeOptionNeedsNormalization && !options.platform && !options.skills && !options.rules && options.runtime === undefined
         && options.aiCli === undefined && options.team === undefined && options.pipeline === undefined) {
       console.log(chalk.yellow('  ⚠ 非交互式模式下未指定任何变更。'));
       console.log(chalk.gray('    使用 --platform, --runtime, --skills, --rules, --ai-cli, --team/--no-team, --pipeline/--no-pipeline'));
@@ -407,7 +415,7 @@ export async function runConfig(directory, options = {}) {
     try {
       console.log(chalk.bold('  选择新配置（按 Enter 保持当前值）:\n'));
 
-      const newRuntime = optionRuntime || await selectRuntime(currentConfig.runtime);
+      const newRuntime = optionRuntime || currentConfig.runtime;
       const newPlatform = await selectPlatform(currentConfig.platform, detected);
       const newAiCli = await selectAiCli(currentConfig.aiCli, detected);
 
@@ -442,11 +450,15 @@ export async function runConfig(directory, options = {}) {
   // ── Phase 3: COMPUTE DIFF ────────────────────────────────────────────────
 
   const changes = [];
-  if (newConfig.platform !== currentConfig.platform) {
+  if (platformManifestNeedsNormalization) {
+    changes.push(`平台: ${platformLabel(detectedPlatformRaw)} → ${platformLabel(newConfig.platform)}`);
+  } else if (newConfig.platform !== currentConfig.platform) {
     changes.push(`平台: ${platformLabel(currentConfig.platform)} → ${platformLabel(newConfig.platform)}`);
   }
-  if (newConfig.runtime !== currentConfig.runtime) {
-    changes.push(`运行系统: ${runtimeLabel(currentConfig.runtime)} → ${runtimeLabel(newConfig.runtime)}`);
+  if (runtimeManifestNeedsNormalization || runtimeOptionNeedsNormalization) {
+    changes.push(`运行时: ${runtimeLabel(rawManifestRuntime)} → ${runtimeLabel(newConfig.runtime)}`);
+  } else if (newConfig.runtime !== currentConfig.runtime) {
+    changes.push(`运行时: ${runtimeLabel(currentConfig.runtime)} → ${runtimeLabel(newConfig.runtime)}`);
   }
   if (newConfig.aiCli !== currentConfig.aiCli) {
     changes.push(`AI CLI: ${currentConfig.aiCli || '(未设置)'} → ${newConfig.aiCli || '(未设置)'}`);
@@ -562,6 +574,9 @@ export async function runConfig(directory, options = {}) {
   // 5d. Install/update files for new + existing platforms
   const allTargetPlatforms = [...platformsToAdd, ...platformsToUpdate];
   const needsReinstall = newConfig.platform !== currentConfig.platform
+    || platformManifestNeedsNormalization
+    || runtimeManifestNeedsNormalization
+    || runtimeOptionNeedsNormalization
     || newConfig.runtime !== currentConfig.runtime
     || newConfig.suite !== currentConfig.suite
     || newConfig.rules !== currentConfig.rules
@@ -595,7 +610,7 @@ export async function runConfig(directory, options = {}) {
   }
 
   // 5e. Pipeline changes
-  if (newConfig.pipeline !== currentConfig.pipeline || (newConfig.pipeline && newConfig.runtime !== currentConfig.runtime)) {
+  if (newConfig.pipeline !== currentConfig.pipeline || (newConfig.pipeline && (newConfig.runtime !== currentConfig.runtime || runtimeManifestNeedsNormalization || runtimeOptionNeedsNormalization))) {
     if (newConfig.pipeline) {
       console.log(chalk.blue('\n    安装 Pipeline:'));
       await installPipeline(projectRoot, false, {
@@ -609,6 +624,12 @@ export async function runConfig(directory, options = {}) {
         await removePipelineFiles(projectRoot, oldPipelineFiles, false);
       }
     }
+  } else if (newConfig.pipeline) {
+    const staleManagedPipelineFiles = await findStaleManagedPipelineFiles(projectRoot, newConfig.runtime);
+    if (staleManagedPipelineFiles.length) {
+      console.log(chalk.blue('\n    移除过期 Pipeline 框架文件:'));
+      await removeStaleManagedPipelineFiles(projectRoot, staleManagedPipelineFiles, false);
+    }
   }
 
   // 5f. Update .gitignore
@@ -616,7 +637,7 @@ export async function runConfig(directory, options = {}) {
   await installGitignore(projectRoot, { pipeline: newConfig.pipeline }, false);
 
   // 5g. Runtime-aware git hook and PrizmKit helper scripts
-  if (newConfig.runtime !== currentConfig.runtime) {
+  if (newConfig.runtime !== currentConfig.runtime || runtimeManifestNeedsNormalization || runtimeOptionNeedsNormalization) {
     console.log(chalk.blue('\n    Git Hook:'));
     await installGitHook(projectRoot, false, newConfig.runtime);
 
@@ -675,7 +696,7 @@ export async function runConfig(directory, options = {}) {
 
   console.log(chalk.gray('  新配置:'));
   console.log(chalk.gray(`    平台:     ${platformLabel(newConfig.platform)}`));
-  console.log(chalk.gray(`    运行系统: ${runtimeLabel(newConfig.runtime)}`));
+  console.log(chalk.gray(`    运行时:   ${runtimeLabel(newConfig.runtime)}`));
   console.log(chalk.gray(`    AI CLI:   ${newConfig.aiCli || '(未设置)'}`));
   console.log(chalk.gray(`    技能套件: ${newConfig.suite}`));
   console.log(chalk.gray(`    规则:     ${newConfig.rules}`));

package/src/index.js

@@ -16,7 +16,6 @@ import { scaffold } from './scaffold.js';
 import { loadMetadata } from './metadata.js';
 import { platformLabel } from './platforms.js';
 import { normalizeRuntime, runtimeLabel } from './runtimes.js';
-import { selectRuntime } from './prompts.js';
 
 export { runUpgrade } from './upgrade.js';
 
@@ -85,10 +84,8 @@ export async function runScaffold(directory, options) {
 
   // === 交互式模式 ===
   try {
-    // 1. 选择运行系统（控制安装的流水线和编排技能）
-    const runtime = options.runtime !== undefined
-      ? normalizeRuntime(options.runtime)
-      : await selectRuntime();
+    // 1. 统一 Python runtime（旧 runtime 参数仅作为兼容别名归一）
+    const runtime = normalizeRuntime(options.runtime);
 
     // 2. 选择平台（控制安装的目录结构）
     const platform = await select({
@@ -243,7 +240,7 @@ export async function runScaffold(directory, options) {
 
     console.log('');
     console.log(chalk.bold('  安装摘要:'));
-    console.log(`    运行系统:   ${chalk.cyan(runtimeLabel(runtime))}`);
+    console.log(`    运行时:     ${chalk.cyan(runtimeLabel(runtime))}`);
     console.log(`    平台:       ${chalk.cyan(selectedPlatformLabel)}`);
     console.log(`    技能:       ${chalk.cyan(suiteLabel)}`);
     console.log(`    团队模式:   ${team ? chalk.green('启用') : chalk.gray('禁用')}`);

package/src/manifest.js

@@ -10,6 +10,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { expandPlatforms, projectMemoryFile } from './platforms.js';
+import { normalizeRuntime } from './runtimes.js';
 
 const MANIFEST_FILE = 'manifest.json';
 const MANIFEST_DIR = '.prizmkit';
@@ -48,7 +49,7 @@ export async function writeManifest(projectRoot, data) {
  * @param {Object} params
  * @param {string} params.version - PrizmKit version
  * @param {string} params.platform - 'codebuddy' | 'claude' | 'codex' | 'all' ('both' supported only for legacy manifests)
- * @param {string} [params.runtime] - 'unix' | 'windows'
+ * @param {string} [params.runtime] - canonical Python runtime id or compatibility alias
  * @param {string} params.suite - skill suite name
  * @param {string[]} params.skills - resolved skill name list
  * @param {string[]} params.agents - agent file names (e.g. ['prizm-dev-team-dev.md'])
@@ -80,7 +81,7 @@ export function buildManifest({
     installedAt: now,
     updatedAt: now,
     platform,
-    runtime: runtime || 'unix',
+    runtime: normalizeRuntime(runtime),
     suite,
     options: {
       team: Boolean(team),

package/src/metadata.js

@@ -9,7 +9,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { normalizeRuntime, RUNTIME_WINDOWS } from './runtimes.js';
+import { normalizeRuntime } from './runtimes.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -72,25 +72,14 @@ export function getSkillsDir() {
 
 /**
  * Return candidate source directories for a skill in priority order.
- * Windows orchestration skills are intentionally sourced from a separate
- * tree so macOS/Linux content remains untouched.
+ * Retired Windows runtime aliases resolve to the canonical skill tree.
  */
-export function getSkillCandidatePaths(skillName, skillDef = {}, runtime = 'unix') {
-  const normalizedRuntime = normalizeRuntime(runtime);
+export function getSkillCandidatePaths(skillName, skillDef = {}, runtime = 'python') {
+  normalizeRuntime(runtime);
   const category = skillDef.category;
   const subcategory = skillDef.subcategory;
   const candidates = [];
 
-  if (normalizedRuntime === RUNTIME_WINDOWS && category) {
-    const windowsCategory = `${category}-windows`;
-    candidates.push(path.join(getBundledRoot(), 'skills-windows', skillName));
-    candidates.push(
-      subcategory
-        ? path.join(getFrameworkRoot(), 'core', 'skills', windowsCategory, subcategory, skillName)
-        : path.join(getFrameworkRoot(), 'core', 'skills', windowsCategory, skillName)
-    );
-  }
-
   candidates.push(path.join(getBundledRoot(), 'skills', skillName));
 
   if (category) {
@@ -147,9 +136,9 @@ export function getTemplatesDir() {
 /**
  * 获取 dev-pipeline 目录路径
  */
-export function getPipelineDir(runtime = 'unix') {
-  const normalizedRuntime = normalizeRuntime(runtime);
-  const dirName = normalizedRuntime === RUNTIME_WINDOWS ? 'dev-pipeline-windows' : 'dev-pipeline';
+export function getPipelineDir(runtime = 'python') {
+  normalizeRuntime(runtime);
+  const dirName = 'dev-pipeline';
   const bundledDir = path.join(getBundledRoot(), dirName);
   const coreDir = path.join(getFrameworkRoot(), dirName);
 

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';
 }