prizmkit 1.1.99 → 1.1.101

package/src/scaffold.js

@@ -28,7 +28,7 @@ import {
 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 { 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
@@ -1615,7 +1632,7 @@ 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)}`));
+    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

@@ -220,7 +220,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';