ly-workflow-codex 0.2.0

package/dist/index.d.mts

@@ -0,0 +1,223 @@
+import * as i18next from 'i18next';
+
+/** 宿主 id（兼容旧配置读取；codex 单宿主只安装 codex） */
+type HostId = 'codex' | 'claude';
+/** 宿主无关的模板渲染配置（共享 LyConfig 的相关切片） */
+interface HostAdapterConfig {
+    /** 审查 agent A 模型（LyConfig.codexHost.reviewModel）；未配置或空白时回退当前会话模型 */
+    reviewModel?: string;
+    /** 审查 agent B 模型（LyConfig.codexHost.reviewModelB）；未配置或空白时回退当前会话模型 */
+    reviewModelB?: string;
+    /** coding subagent（实施）模型（LyConfig.codexHost.codingModel）；未配置或空白时回退当前会话模型 */
+    codingModel?: string;
+}
+/** 适配器安装/卸载/校验共用的上下文 */
+interface HostAdapterContext {
+    /** 宿主安装根目录（保留统一形态；codex 宿主不使用） */
+    installDir: string;
+    force: boolean;
+    /** npm 包内 templates/ 目录 */
+    templateDir: string;
+    /** 共享角色词位置（~/.ly/prompts/，测试可注入） */
+    promptsDir: string;
+    /** codex skills 安装目录（~/.agents/skills/，测试可注入） */
+    codexSkillsDir: string;
+    config: HostAdapterConfig;
+    result: InstallResult;
+}
+/** 命令模板的源目录与安装目标 */
+interface HostTemplateTarget {
+    sourceDir: string;
+    targetDir: string;
+    /** 目标目录名前缀（codex 宿主 = 'lyx-'，安装为 <targetDir>/lyx-<cmd>/SKILL.md） */
+    filePrefix?: string;
+}
+interface HostAdapter {
+    id: HostId;
+    /** 命令模板安装目标（源目录 + 目标目录 + 文件名前缀） */
+    promptsTarget: (ctx: HostAdapterContext) => HostTemplateTarget;
+    /** 模板渲染规则：宿主可追加宿主专属变量处理（在共享 injectConfigVariables 之后） */
+    renderTemplate: (content: string, ctx: HostAdapterContext) => string;
+    /** 卸载清单：该宿主名下的产物路径清单（lyx-* 绝对路径清单） */
+    uninstallList: (ctx: HostAdapterContext) => Promise<string[]>;
+    /** 可选：宿主专属的附加安装步骤（codex 无） */
+    installExtras?: (ctx: HostAdapterContext) => Promise<void>;
+    /** 可选：安装后校验（codex = ROLE_FILE 目标存在性） */
+    verify?: (ctx: HostAdapterContext) => Promise<void>;
+}
+/** 统一注册表（codex 单宿主；保留 Record 形态供未来扩展） */
+declare const ADAPTERS: Record<'codex', HostAdapter>;
+
+interface CliOptions {
+    lang?: SupportedLang;
+    force?: boolean;
+    skipPrompt?: boolean;
+    workflows?: string;
+    installDir?: string;
+}
+
+type SupportedLang = 'zh-CN' | 'en';
+interface LyConfig {
+    general: {
+        version: string;
+        language: SupportedLang;
+        createdAt: string;
+    };
+    workflows: {
+        installed: string[];
+    };
+    installedHosts?: HostId[];
+    paths: {
+        commands: string;
+        prompts: string;
+        backup: string;
+    };
+    codexHost?: {
+        reviewModel?: string;
+        reviewModelB?: string;
+        codingModel?: string;
+    };
+}
+interface WorkflowConfig {
+    id: string;
+    name: string;
+    nameEn: string;
+    category: string;
+    commands: string[];
+    defaultSelected: boolean;
+    order: number;
+    description?: string;
+    descriptionEn?: string;
+}
+interface InitOptions {
+    lang?: SupportedLang;
+    skipPrompt?: boolean;
+    force?: boolean;
+    workflows?: string;
+    installDir?: string;
+}
+interface InstallResult {
+    success: boolean;
+    installedCommands: string[];
+    installedPrompts: string[];
+    /** 非 force 安装时因目标已存在而跳过的命令（修复"假成功"计数，供共存提示） */
+    skippedCommands?: string[];
+    errors: string[];
+    configPath: string;
+}
+
+declare function init(options?: InitOptions): Promise<void>;
+
+declare function showMainMenu(): Promise<void>;
+
+/**
+ * Main update command - checks for updates and installs if available
+ */
+declare function update(): Promise<void>;
+
+declare const i18n: i18next.i18n;
+declare function initI18n(lang?: SupportedLang): Promise<void>;
+declare function changeLanguage(lang: SupportedLang): Promise<void>;
+
+declare function getLyPromptsDir(): string;
+declare function getLyDir(): string;
+declare function getConfigPath(): string;
+declare function readLyConfig(): Promise<LyConfig | null>;
+declare function writeLyConfig(config: LyConfig): Promise<void>;
+declare function createDefaultConfig(options: {
+    language: SupportedLang;
+    installedWorkflows: string[];
+    codexHost?: {
+        reviewModel?: string;
+        reviewModelB?: string;
+        codingModel?: string;
+    };
+    /** 已安装宿主集合（兼容旧配置；codex 单宿主缺省 ['codex']） */
+    installedHosts?: HostId[];
+}): LyConfig;
+
+declare function getWorkflowConfigs(): WorkflowConfig[];
+declare function getWorkflowById(id: string): WorkflowConfig | undefined;
+
+/**
+ * installWorkflows 的配置入参。
+ * promptsDir / codexSkillsDir 供测试注入，缺省用真实 homedir 路径。
+ */
+interface InstallWorkflowsConfig {
+    /** codex 宿主审查模型（LyConfig.codexHost.reviewModel） */
+    reviewModel?: string;
+    /** 共享角色词目录（默认 ~/.ly/prompts/） */
+    promptsDir?: string;
+    /** codex skills 安装目录（默认 ~/.agents/skills/，测试可注入） */
+    codexSkillsDir?: string;
+}
+/**
+ * 旧位置角色词迁移：~/.claude/.ly/prompts/ → ~/.ly/prompts/（内容移动 + 旧目录清理）。
+ * 失败不抛出（返回 error 字段，调用方报告但不阻断安装主流程）。
+ */
+interface PromptsMigrationResult {
+    migrated: boolean;
+    from?: string;
+    to?: string;
+    error?: string;
+}
+declare function migrateLegacyPrompts(options?: {
+    homeDir?: string;
+    promptsDir?: string;
+}): Promise<PromptsMigrationResult>;
+declare function installWorkflows(workflowIds: string[], installDir: string, force?: boolean, config?: InstallWorkflowsConfig): Promise<InstallResult>;
+interface UninstallResult {
+    success: boolean;
+    /** 移除的 ~/.agents/skills/lyx-* skill 目录名 */
+    removedSkills: string[];
+    /** 清理的旧安装位残留 ~/.codex/prompts/ly-*.md 文件名 */
+    removedLegacyPrompts: string[];
+    /** 是否清除了共享角色词子目录 ~/.ly/prompts/codex/（父目录与其余子目录保留） */
+    removedSharedPrompts: boolean;
+    /** 共享配置 ~/.ly/config.toml 是否保留（保守策略：一律保留，仅提示） */
+    configTomlKept: boolean;
+    errors: string[];
+}
+/**
+ * Uninstall workflows（codex 单宿主）：
+ * - 移除 ~/.agents/skills/ly-* skill 目录，并清理旧安装位 ~/.codex/prompts/ly-*.md 残留
+ * - 仅移除共享角色词子目录 ~/.ly/prompts/codex/（本包归属产物；父目录与其余子目录保留）
+ * - 保留共享配置 ~/.ly/config.toml（~/.ly 为 ly-workflow 共享命名空间，含 worktrees 等真实数据）
+ * - 触发 codex 侧残留清理（AGENTS.md 区块 / config.toml 旧区块 / 旧 agents）
+ */
+declare function uninstallWorkflows(installDir: string, options?: {
+    legacyCleanupDirs?: {
+        codexDir?: string;
+        homeDir?: string;
+    };
+    lyPromptsDir?: string;
+    /** codex skills 安装目录（默认 ~/.agents/skills/，测试可注入） */
+    codexSkillsDir?: string;
+    /** 共享配置目录（默认 ~/.ly，测试可注入） */
+    lyDir?: string;
+}): Promise<UninstallResult>;
+
+/**
+ * Get current installed version from package.json
+ */
+declare function getCurrentVersion(): Promise<string>;
+/**
+ * Get latest version from npm registry
+ */
+declare function getLatestVersion(packageName?: string): Promise<string | null>;
+/**
+ * Compare two semantic versions
+ * @returns 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Check if update is available
+ */
+declare function checkForUpdates(): Promise<{
+    hasUpdate: boolean;
+    currentVersion: string;
+    latestVersion: string | null;
+}>;
+
+export { ADAPTERS, changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, getConfigPath, getCurrentVersion, getLatestVersion, getLyDir, getLyPromptsDir, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installWorkflows, migrateLegacyPrompts, readLyConfig, showMainMenu, uninstallWorkflows, update, writeLyConfig };
+export type { CliOptions, HostAdapter, HostId, InitOptions, InstallResult, LyConfig, SupportedLang, WorkflowConfig };

package/dist/index.d.ts

@@ -0,0 +1,223 @@
+import * as i18next from 'i18next';
+
+/** 宿主 id（兼容旧配置读取；codex 单宿主只安装 codex） */
+type HostId = 'codex' | 'claude';
+/** 宿主无关的模板渲染配置（共享 LyConfig 的相关切片） */
+interface HostAdapterConfig {
+    /** 审查 agent A 模型（LyConfig.codexHost.reviewModel）；未配置或空白时回退当前会话模型 */
+    reviewModel?: string;
+    /** 审查 agent B 模型（LyConfig.codexHost.reviewModelB）；未配置或空白时回退当前会话模型 */
+    reviewModelB?: string;
+    /** coding subagent（实施）模型（LyConfig.codexHost.codingModel）；未配置或空白时回退当前会话模型 */
+    codingModel?: string;
+}
+/** 适配器安装/卸载/校验共用的上下文 */
+interface HostAdapterContext {
+    /** 宿主安装根目录（保留统一形态；codex 宿主不使用） */
+    installDir: string;
+    force: boolean;
+    /** npm 包内 templates/ 目录 */
+    templateDir: string;
+    /** 共享角色词位置（~/.ly/prompts/，测试可注入） */
+    promptsDir: string;
+    /** codex skills 安装目录（~/.agents/skills/，测试可注入） */
+    codexSkillsDir: string;
+    config: HostAdapterConfig;
+    result: InstallResult;
+}
+/** 命令模板的源目录与安装目标 */
+interface HostTemplateTarget {
+    sourceDir: string;
+    targetDir: string;
+    /** 目标目录名前缀（codex 宿主 = 'lyx-'，安装为 <targetDir>/lyx-<cmd>/SKILL.md） */
+    filePrefix?: string;
+}
+interface HostAdapter {
+    id: HostId;
+    /** 命令模板安装目标（源目录 + 目标目录 + 文件名前缀） */
+    promptsTarget: (ctx: HostAdapterContext) => HostTemplateTarget;
+    /** 模板渲染规则：宿主可追加宿主专属变量处理（在共享 injectConfigVariables 之后） */
+    renderTemplate: (content: string, ctx: HostAdapterContext) => string;
+    /** 卸载清单：该宿主名下的产物路径清单（lyx-* 绝对路径清单） */
+    uninstallList: (ctx: HostAdapterContext) => Promise<string[]>;
+    /** 可选：宿主专属的附加安装步骤（codex 无） */
+    installExtras?: (ctx: HostAdapterContext) => Promise<void>;
+    /** 可选：安装后校验（codex = ROLE_FILE 目标存在性） */
+    verify?: (ctx: HostAdapterContext) => Promise<void>;
+}
+/** 统一注册表（codex 单宿主；保留 Record 形态供未来扩展） */
+declare const ADAPTERS: Record<'codex', HostAdapter>;
+
+interface CliOptions {
+    lang?: SupportedLang;
+    force?: boolean;
+    skipPrompt?: boolean;
+    workflows?: string;
+    installDir?: string;
+}
+
+type SupportedLang = 'zh-CN' | 'en';
+interface LyConfig {
+    general: {
+        version: string;
+        language: SupportedLang;
+        createdAt: string;
+    };
+    workflows: {
+        installed: string[];
+    };
+    installedHosts?: HostId[];
+    paths: {
+        commands: string;
+        prompts: string;
+        backup: string;
+    };
+    codexHost?: {
+        reviewModel?: string;
+        reviewModelB?: string;
+        codingModel?: string;
+    };
+}
+interface WorkflowConfig {
+    id: string;
+    name: string;
+    nameEn: string;
+    category: string;
+    commands: string[];
+    defaultSelected: boolean;
+    order: number;
+    description?: string;
+    descriptionEn?: string;
+}
+interface InitOptions {
+    lang?: SupportedLang;
+    skipPrompt?: boolean;
+    force?: boolean;
+    workflows?: string;
+    installDir?: string;
+}
+interface InstallResult {
+    success: boolean;
+    installedCommands: string[];
+    installedPrompts: string[];
+    /** 非 force 安装时因目标已存在而跳过的命令（修复"假成功"计数，供共存提示） */
+    skippedCommands?: string[];
+    errors: string[];
+    configPath: string;
+}
+
+declare function init(options?: InitOptions): Promise<void>;
+
+declare function showMainMenu(): Promise<void>;
+
+/**
+ * Main update command - checks for updates and installs if available
+ */
+declare function update(): Promise<void>;
+
+declare const i18n: i18next.i18n;
+declare function initI18n(lang?: SupportedLang): Promise<void>;
+declare function changeLanguage(lang: SupportedLang): Promise<void>;
+
+declare function getLyPromptsDir(): string;
+declare function getLyDir(): string;
+declare function getConfigPath(): string;
+declare function readLyConfig(): Promise<LyConfig | null>;
+declare function writeLyConfig(config: LyConfig): Promise<void>;
+declare function createDefaultConfig(options: {
+    language: SupportedLang;
+    installedWorkflows: string[];
+    codexHost?: {
+        reviewModel?: string;
+        reviewModelB?: string;
+        codingModel?: string;
+    };
+    /** 已安装宿主集合（兼容旧配置；codex 单宿主缺省 ['codex']） */
+    installedHosts?: HostId[];
+}): LyConfig;
+
+declare function getWorkflowConfigs(): WorkflowConfig[];
+declare function getWorkflowById(id: string): WorkflowConfig | undefined;
+
+/**
+ * installWorkflows 的配置入参。
+ * promptsDir / codexSkillsDir 供测试注入，缺省用真实 homedir 路径。
+ */
+interface InstallWorkflowsConfig {
+    /** codex 宿主审查模型（LyConfig.codexHost.reviewModel） */
+    reviewModel?: string;
+    /** 共享角色词目录（默认 ~/.ly/prompts/） */
+    promptsDir?: string;
+    /** codex skills 安装目录（默认 ~/.agents/skills/，测试可注入） */
+    codexSkillsDir?: string;
+}
+/**
+ * 旧位置角色词迁移：~/.claude/.ly/prompts/ → ~/.ly/prompts/（内容移动 + 旧目录清理）。
+ * 失败不抛出（返回 error 字段，调用方报告但不阻断安装主流程）。
+ */
+interface PromptsMigrationResult {
+    migrated: boolean;
+    from?: string;
+    to?: string;
+    error?: string;
+}
+declare function migrateLegacyPrompts(options?: {
+    homeDir?: string;
+    promptsDir?: string;
+}): Promise<PromptsMigrationResult>;
+declare function installWorkflows(workflowIds: string[], installDir: string, force?: boolean, config?: InstallWorkflowsConfig): Promise<InstallResult>;
+interface UninstallResult {
+    success: boolean;
+    /** 移除的 ~/.agents/skills/lyx-* skill 目录名 */
+    removedSkills: string[];
+    /** 清理的旧安装位残留 ~/.codex/prompts/ly-*.md 文件名 */
+    removedLegacyPrompts: string[];
+    /** 是否清除了共享角色词子目录 ~/.ly/prompts/codex/（父目录与其余子目录保留） */
+    removedSharedPrompts: boolean;
+    /** 共享配置 ~/.ly/config.toml 是否保留（保守策略：一律保留，仅提示） */
+    configTomlKept: boolean;
+    errors: string[];
+}
+/**
+ * Uninstall workflows（codex 单宿主）：
+ * - 移除 ~/.agents/skills/ly-* skill 目录，并清理旧安装位 ~/.codex/prompts/ly-*.md 残留
+ * - 仅移除共享角色词子目录 ~/.ly/prompts/codex/（本包归属产物；父目录与其余子目录保留）
+ * - 保留共享配置 ~/.ly/config.toml（~/.ly 为 ly-workflow 共享命名空间，含 worktrees 等真实数据）
+ * - 触发 codex 侧残留清理（AGENTS.md 区块 / config.toml 旧区块 / 旧 agents）
+ */
+declare function uninstallWorkflows(installDir: string, options?: {
+    legacyCleanupDirs?: {
+        codexDir?: string;
+        homeDir?: string;
+    };
+    lyPromptsDir?: string;
+    /** codex skills 安装目录（默认 ~/.agents/skills/，测试可注入） */
+    codexSkillsDir?: string;
+    /** 共享配置目录（默认 ~/.ly，测试可注入） */
+    lyDir?: string;
+}): Promise<UninstallResult>;
+
+/**
+ * Get current installed version from package.json
+ */
+declare function getCurrentVersion(): Promise<string>;
+/**
+ * Get latest version from npm registry
+ */
+declare function getLatestVersion(packageName?: string): Promise<string | null>;
+/**
+ * Compare two semantic versions
+ * @returns 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Check if update is available
+ */
+declare function checkForUpdates(): Promise<{
+    hasUpdate: boolean;
+    currentVersion: string;
+    latestVersion: string | null;
+}>;
+
+export { ADAPTERS, changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, getConfigPath, getCurrentVersion, getLatestVersion, getLyDir, getLyPromptsDir, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installWorkflows, migrateLegacyPrompts, readLyConfig, showMainMenu, uninstallWorkflows, update, writeLyConfig };
+export type { CliOptions, HostAdapter, HostId, InitOptions, InstallResult, LyConfig, SupportedLang, WorkflowConfig };

package/dist/index.mjs

@@ -0,0 +1,12 @@
+export { A as ADAPTERS, c as changeLanguage, n as checkForUpdates, o as compareVersions, d as createDefaultConfig, g as getConfigPath, p as getCurrentVersion, q as getLatestVersion, e as getLyDir, f as getLyPromptsDir, h as getWorkflowById, j as getWorkflowConfigs, a as i18n, i as init, b as initI18n, k as installWorkflows, m as migrateLegacyPrompts, r as readLyConfig, s as showMainMenu, l as uninstallWorkflows, u as update, w as writeLyConfig } from './shared/ly-workflow-codex.K-E7PMp3.mjs';
+import 'node:child_process';
+import 'node:os';
+import 'node:util';
+import 'ansis';
+import 'fs-extra';
+import 'inquirer';
+import 'ora';
+import 'pathe';
+import 'smol-toml';
+import 'i18next';
+import 'node:url';