prizmkit 1.1.142 → 1.1.144

package/src/prompts.js

@@ -37,13 +37,13 @@ export function __resetAiCliPromptsForTests() {
 }
 
 /**
- * Select target platform (codebuddy, claude, codex, or all).
+ * Select target platform (codebuddy, claude, codex, pi, or all).
  * @param {string} currentPlatform - current platform value
  * @param {Object} detected - detected environment info (e.g., { cbc: true, claude: false })
  * @returns {Promise<string>}
  */
 export async function selectPlatform(currentPlatform, detected = {}) {
-  const selectablePlatforms = ['codebuddy', 'claude', 'codex', 'all'];
+  const selectablePlatforms = ['codebuddy', 'claude', 'codex', 'pi', 'all'];
   const detectedDefault = selectablePlatforms.includes(detected.suggested)
     ? detected.suggested
     : 'claude';
@@ -68,6 +68,10 @@ export async function selectPlatform(currentPlatform, detected = {}) {
         name: `Codex (AGENTS.md + .agents/skills + .codex/)${detected.codex ? chalk.green(' ← 已检测到 codex') : ''}`,
         value: 'codex',
       },
+      {
+        name: `Pi (.pi/skills + .pi/APPEND_SYSTEM.md)${detected.pi ? chalk.green(' ← 已检测到 pi') : ''}`,
+        value: 'pi',
+      },
       {
         name: `同时安装全部平台 (${platformLabel('all')})`,
         value: 'all',
@@ -79,7 +83,7 @@ export async function selectPlatform(currentPlatform, detected = {}) {
 }
 
 /**
- * Select AI CLI command (cbc, claude, codex, custom, or skip).
+ * Select AI CLI command (cbc, claude, codex, pi, custom, or skip).
  * @param {string} currentCommand - current AI CLI command
  * @param {Object} detected - detected environment info
  * @returns {Promise<string>} - known command, custom string, or ''
@@ -98,6 +102,10 @@ export async function selectAiCli(currentCommand, detected = {}) {
       name: `codex — Codex CLI${detected.codex ? chalk.green(' ✓ 已安装') : chalk.gray(' (未检测到)')}`,
       value: 'codex',
     },
+    {
+      name: `pi — Pi Coding Agent${detected.pi ? chalk.green(' ✓ 已安装') : chalk.gray(' (未检测到)')}`,
+      value: 'pi',
+    },
     {
       name: '自定义 — 输入其他命令',
       value: '__custom__',
@@ -108,7 +116,7 @@ export async function selectAiCli(currentCommand, detected = {}) {
     },
   ];
 
-  const knownCliValues = ['cbc', 'claude', 'codex'];
+  const knownCliValues = ['cbc', 'claude', 'codex', 'pi'];
   const cliDefault = knownCliValues.includes(currentCommand)
     ? currentCommand
     : (currentCommand ? '__custom__' : (detected.suggestedCli || ''));

package/src/scaffold.js

@@ -96,6 +96,7 @@ async function removeEmptyDirectory(dirPath) {
 }
 
 export async function removeRetiredAgentTeamArtifacts(platform, projectRoot, dryRun) {
+  if (platform === 'pi') return;
   const agentDir = platform === 'claude'
     ? path.join(projectRoot, '.claude', 'agents')
     : platform === 'codex'
@@ -231,12 +232,16 @@ export async function installSkills(platform, skills, projectRoot, dryRun, runti
   // Load Claude command adapter for skill conversion
   let convertSkillToCommand;
   let convertSkillToCodex;
+  let convertSkillToPi;
   if (platform === 'claude') {
     const commandAdapter = await loadAdapter('claude', 'command-adapter.js');
     convertSkillToCommand = commandAdapter.convertSkillToCommand;
   } else if (platform === 'codex') {
     const codexSkillAdapter = await loadAdapter('codex', 'skill-adapter.js');
     convertSkillToCodex = codexSkillAdapter.convertSkill;
+  } else if (platform === 'pi') {
+    const piSkillAdapter = await loadAdapter('pi', 'skill-adapter.js');
+    convertSkillToPi = piSkillAdapter.convertSkill;
   }
 
   for (const skillName of skills) {
@@ -347,6 +352,25 @@ export async function installSkills(platform, skills, projectRoot, dryRun, runti
         }
       }
       console.log(chalk.green(`      ✓ .agents/skills/${skillName}/`));
+    } else if (platform === 'pi') {
+      const content = await fs.readFile(skillMdPath, 'utf8');
+      const converted = convertSkillToPi(content, skillName);
+      const targetDir = path.join(projectRoot, '.pi', 'skills', skillName);
+
+      if (dryRun) {
+        console.log(chalk.gray(`      [dry-run] .pi/skills/${skillName}/`));
+        continue;
+      }
+
+      await fs.remove(targetDir);
+      await fs.ensureDir(targetDir);
+      await fs.writeFile(path.join(targetDir, 'SKILL.md'), converted);
+      for (const entry of await fs.readdir(corePath, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+          await fs.copy(path.join(corePath, entry.name), path.join(targetDir, entry.name));
+        }
+      }
+      console.log(chalk.green(`      ✓ .pi/skills/${skillName}/`));
     }
   }
 }
@@ -503,6 +527,18 @@ job_max_runtime_seconds = 3300
     await installCodexRules(projectRoot, ruleFiles);
     removeLegacyCodexRules(projectRoot, allRuleFileNames);
     console.log(chalk.green(`      ✓ .agents/rules/ (${ruleFiles.length} 条规则)`));
+  } else if (platform === 'pi') {
+    if (dryRun) {
+      console.log(chalk.gray('      [dry-run] .pi/settings.json'));
+      console.log(chalk.gray(`      [dry-run] .pi/rules/ (${ruleFiles.length} 条规则)`));
+      return;
+    }
+    const { generateSettings } = await loadAdapter('pi', 'settings-adapter.js');
+    const { installRules } = await loadAdapter('pi', 'rules-adapter.js');
+    await generateSettings(projectRoot);
+    await installRules(projectRoot, ruleFiles);
+    console.log(chalk.green('      ✓ .pi/settings.json'));
+    console.log(chalk.green(`      ✓ .pi/rules/ (${ruleFiles.length} 条规则)`));
   }
 }
 
@@ -724,6 +760,8 @@ export async function installPrizmkitScripts(projectRoot, dryRun, runtime = 'pyt
   const scripts = [
     'validate-prizm-docs.py',
     'diff-prizm-docs.py',
+    'commit-intent-status.py',
+    'post-command-prizm-drift.py',
   ];
   const legacyManagedScripts = [
     'validate-prizm-docs.sh',
@@ -925,11 +963,11 @@ export async function installProjectMemory(platform, projectRoot, dryRun) {
   const templateName = 'project-memory-template.md';
   const mainName = projectMemoryFile(platform);
   const privateName = privateProjectMemoryFile(platform);
-  if (!mainName || !privateName) return;
+  if (!privateName) return;
 
-  const mainPath = path.join(projectRoot, mainName);
+  const mainPath = mainName ? path.join(projectRoot, mainName) : null;
   const privatePath = path.join(projectRoot, privateName);
-  const importPointer = `@./${privateName}`;
+  const importPointer = mainName ? `@./${privateName}` : null;
 
   const templateCandidates = [
     path.join(templatesDir, templateName),
@@ -942,7 +980,18 @@ export async function installProjectMemory(platform, projectRoot, dryRun) {
   }
 
   let templateContent = (await fs.readFile(templatePath, 'utf-8')).trimEnd();
-  if (platform === 'codex') {
+  if (platform === 'pi') {
+    templateContent = templateContent.replace(
+      '### Available Commands\nRun `/prizmkit` to see all available PrizmKit commands.',
+      `### Available PrizmKit Skills
+Pi discovers project skills from \`.pi/skills/\`. Invoke them with \`/skill:<name>\` (for example \`/skill:prizmkit-plan\`).
+
+- Start with \`/skill:prizmkit\` to see all available PrizmKit skills.
+- Skill assets and references live inside each \`.pi/skills/<skill>/\` directory.
+- PrizmKit behavioral rules live in \`.pi/rules/\`; read the relevant Markdown guidance before commit, documentation, or context-loading work.
+`
+    );
+  } else if (platform === 'codex') {
     templateContent = templateContent.replace(
       '### Available Commands\nRun `/prizmkit` to see all available PrizmKit commands.',
       `### Available PrizmKit Skills
@@ -957,10 +1006,11 @@ Codex discovers repository skills from \`.agents/skills/\`. When a user or promp
 
   if (dryRun) {
     console.log(chalk.gray(`      [dry-run] ${privateName}`));
-    console.log(chalk.gray(`      [dry-run] ${mainName} import ${importPointer}`));
+    if (mainName) console.log(chalk.gray(`      [dry-run] ${mainName} import ${importPointer}`));
     return;
   }
 
+  await fs.ensureDir(path.dirname(privatePath));
   if (!await fs.pathExists(privatePath)) {
     await fs.writeFile(privatePath, `${templateContent}\n`, 'utf-8');
     console.log(chalk.green(`      ✓ ${privateName} (created PrizmKit section)`));
@@ -975,18 +1025,20 @@ Codex discovers repository skills from \`.agents/skills/\`. When a user or promp
     }
   }
 
-  const existingMain = await fs.pathExists(mainPath)
-    ? await fs.readFile(mainPath, 'utf-8')
-    : '';
-  const mainMerge = ensureSingleImportPointer(existingMain, importPointer);
-  logManagedProjectMemoryWarnings(mainName, mainMerge.warnings);
-  const nextMain = mainMerge.content;
-  if (nextMain !== existingMain) {
-    await fs.writeFile(mainPath, nextMain, 'utf-8');
-    const migrationSuffix = mainMerge.removedBlocks.length ? ' and migrated managed block' : '';
-    console.log(chalk.green(`      ✓ ${mainName} (imports ${privateName}${migrationSuffix})`));
-  } else {
-    console.log(chalk.green(`      ✓ ${mainName} (import up-to-date)`));
+  if (mainPath && importPointer) {
+    const existingMain = await fs.pathExists(mainPath)
+      ? await fs.readFile(mainPath, 'utf-8')
+      : '';
+    const mainMerge = ensureSingleImportPointer(existingMain, importPointer);
+    logManagedProjectMemoryWarnings(mainName, mainMerge.warnings);
+    const nextMain = mainMerge.content;
+    if (nextMain !== existingMain) {
+      await fs.writeFile(mainPath, nextMain, 'utf-8');
+      const migrationSuffix = mainMerge.removedBlocks.length ? ' and migrated managed block' : '';
+      console.log(chalk.green(`      ✓ ${mainName} (imports ${privateName}${migrationSuffix})`));
+    } else {
+      console.log(chalk.green(`      ✓ ${mainName} (import up-to-date)`));
+    }
   }
 }
 
@@ -1475,7 +1527,7 @@ export const EXTRAS_REGISTRY = {
 /**
  * 执行纯净安装
  * @param {Object} config
- * @param {string} config.platform - 'codebuddy' | 'claude' | 'codex' | 'all'
+ * @param {string} config.platform - 'codebuddy' | 'claude' | 'codex' | 'pi' | 'all'
  * @param {string} [config.runtime] - 'python' (legacy aliases accepted: 'unix' | 'windows')
  * @param {string} config.skills - 'core' | 'minimal' | 'recommended:<type>'
  * @param {boolean} config.pipeline - 是否安装 dev-pipeline
@@ -1497,7 +1549,7 @@ export async function scaffold(config) {
   });
   const resolvedAiCli = launchSelection.aiCli;
   if (!isKnownPlatform(platform)) {
-    throw new Error(`Unknown platform "${platform}". Expected codebuddy, claude, codex, or all.`);
+    throw new Error(`Unknown platform "${platform}". Expected codebuddy, claude, codex, pi, or all.`);
   }
   const platforms = expandPlatforms(platform);
   const payloadPlatforms = resolvePayloadPlatforms(platform, resolvedAiCli);
@@ -1677,7 +1729,9 @@ export async function scaffold(config) {
     console.log(`    2. ${chalk.cyan(cli)}                          ${chalk.gray('# 启动 AI 对话')}`);
     const initInstruction = mainPlatform === 'codex'
       ? '说 "运行 prizmkit-init"'
-      : '说 "/prizmkit-init"';
+      : mainPlatform === 'pi'
+        ? '输入 "/skill:prizmkit-init"'
+        : '说 "/prizmkit-init"';
     console.log(`    3. ${chalk.cyan(initInstruction)}           ${chalk.gray('# 初始化项目上下文')}`);
 
     if (pipeline) {

package/src/upgrade.js

@@ -73,14 +73,16 @@ export async function removeSkillFiles(platform, projectRoot, skillNames, dryRun
           console.log(chalk.red(`      ✗ removed .codebuddy/skills/${skillName}/`));
         }
       }
-    } else if (platform === 'codex') {
-      const skillDir = path.join(projectRoot, '.agents', 'skills', skillName);
+    } else if (platform === 'codex' || platform === 'pi') {
+      const skillDir = platform === 'pi'
+        ? path.join(projectRoot, '.pi', 'skills', skillName)
+        : path.join(projectRoot, '.agents', 'skills', skillName);
       if (await fs.pathExists(skillDir)) {
         if (dryRun) {
-          console.log(chalk.gray(`      [dry-run] remove .agents/skills/${skillName}/`));
+          console.log(chalk.gray(`      [dry-run] remove ${path.relative(projectRoot, skillDir)}/`));
         } else {
           await fs.remove(skillDir);
-          console.log(chalk.red(`      ✗ removed .agents/skills/${skillName}/`));
+          console.log(chalk.red(`      ✗ removed ${path.relative(projectRoot, skillDir)}/`));
         }
       }
     }
@@ -91,6 +93,7 @@ export async function removeSkillFiles(platform, projectRoot, skillNames, dryRun
  * Remove agent files for a specific platform.
  */
 export async function removeAgentFiles(platform, projectRoot, agentFileNames, dryRun) {
+  if (platform === 'pi') return;
   for (const fileName of agentFileNames) {
     const dir = platform === 'claude'
       ? path.join(projectRoot, '.claude', 'agents')
@@ -124,7 +127,9 @@ export async function removeRuleFiles(platform, projectRoot, ruleFileNames, dryR
       ? path.join(projectRoot, '.claude', 'rules')
       : platform === 'codex'
         ? path.join(projectRoot, '.agents', 'rules')
-        : path.join(projectRoot, '.codebuddy', 'rules');
+        : platform === 'pi'
+          ? path.join(projectRoot, '.pi', 'rules')
+          : path.join(projectRoot, '.codebuddy', 'rules');
     // Rules are stored as .md for claude, .mdc for codebuddy
     const targetName = platform === 'codebuddy'
       ? baseName.replace(/\.md$/, '.mdc')
@@ -243,11 +248,13 @@ export async function runUpgrade(directory, options = {}) {
     const hasClaude = await hasPlatformFiles(path.join(projectRoot, '.claude', 'commands'));
     const hasCodeBuddy = await hasPlatformFiles(path.join(projectRoot, '.codebuddy', 'skills'));
     const hasCodex = await hasPlatformFiles(path.join(projectRoot, '.agents', 'skills'));
+    const hasPi = await hasPlatformFiles(path.join(projectRoot, '.pi', 'skills'));
 
     const detectedPlatforms = [
       hasCodeBuddy && 'codebuddy',
       hasClaude && 'claude',
       hasCodex && 'codex',
+      hasPi && 'pi',
     ].filter(Boolean);
 
     if (detectedPlatforms.length > 1) platform = 'all';