@prd-improve/cli 1.0.0

package/dist/i18n/help.en.js

@@ -0,0 +1,150 @@
+import { SCHEMA_VERSION_CURRENT } from "../schema/prd.js";
+export default {
+    program_desc: `PRD Improve CLI — schema ${SCHEMA_VERSION_CURRENT}`,
+    program_lang_opt: "Output language zh | en, place before command (priority flag > PRD_LANG > config > default zh)",
+    group: {
+        lifecycle: "Lifecycle (offline)",
+        auth: "Auth / session",
+        sync: "Backend sync",
+        team: "Team / project",
+        admin: "Admin / config",
+    },
+    cmd: {
+        init: {
+            desc: "Initialize .prd/ workspace; with slug, also write a v0.2 yaml stub",
+            opts: {
+                workspace: "workspace name (default: cwd basename)",
+                team: "team slug for new yaml (default from ~/.prdrc default_team)",
+                project: "project slug for new yaml (default from ~/.prdrc default_project)",
+                backend: "rc backend name (selects which backend's default_team / default_project to read)",
+            },
+        },
+        freeze: {
+            desc: "Freeze working/prd.yaml as immutable snapshot",
+            opts: {
+                version: "version vX.Y[.Z]",
+                auto: "auto-increment from existing",
+            },
+        },
+        context: {
+            desc: "Render PRD as slim Markdown for coding agent",
+            opts: {
+                feature: "feature slug (required)",
+                version: "read specific frozen version",
+                working: "read working/prd.yaml (mutually exclusive with --version)",
+                includeQuestions: "include open_questions section",
+                out: "write to file instead of stdout",
+            },
+        },
+        diff: {
+            desc: "Diff two PRD versions (ID-level semantic)",
+            opts: {
+                feature: "feature slug (required)",
+                from: "from ref (defaults to latest frozen)",
+                to: "to ref (defaults to working)",
+            },
+        },
+        refresh: {
+            desc: "Render refresh index view",
+            opts: {
+                feature: "feature slug (required)",
+                newPrd: "new PRD file path (for anchor slice)",
+                prdAnchor: "PRD heading text (exact / prefix / substring)",
+                prdAnchorExact: "anchor exact match only",
+                out: "write to file (default stdout)",
+                format: "output format md | json",
+            },
+        },
+        validate: {
+            desc: "Validate PRD file(s)",
+            opts: {
+                feature: "Validate one feature only",
+            },
+        },
+        "migrate-yaml": {
+            desc: "Upgrade yaml v0.1 → v0.2 (insert meta.team / meta.project)",
+            opts: {
+                team: "overrides ~/.prdrc default_team",
+                project: "overrides ~/.prdrc default_project",
+                nonInteractive: "disable prompts; requires --team / --project",
+                backend: "select backend from ~/.prdrc",
+            },
+        },
+        push: {
+            desc: "Push working PRD to backend",
+            opts: {
+                backend: "select backend from ~/.prdrc",
+                allowCreate: "create new feature on backend",
+                skipFrozen: "skip frozen-version sync",
+            },
+        },
+        pull: {
+            desc: "Pull latest from backend",
+            opts: {
+                backend: "select backend",
+                stash: "stash local edits to .prd/.conflicts/ before fast-forward",
+                force: "overwrite local uncommitted changes",
+            },
+        },
+        status: {
+            desc: "Show sync status",
+            opts: {
+                backend: "select backend",
+            },
+        },
+        login: {
+            desc: "Login and store token in ~/.prdrc",
+            opts: {
+                backend: "backend name in rc",
+                url: "backend URL",
+                bootstrap: "use bootstrap secret",
+                admin: "explicit admin-token login",
+            },
+        },
+        logout: {
+            desc: "Logout (revoke + wipe local)",
+            opts: {
+                backend: "backend name in rc",
+            },
+        },
+        whoami: {
+            desc: "Show current user",
+            opts: {
+                backend: "backend name in rc",
+            },
+        },
+        team: {
+            desc: "List teams visible to current user",
+            opts: {
+                backend: "backend name in rc",
+            },
+            sub: {
+                list: "List teams I have membership in",
+            },
+        },
+        project: {
+            desc: "List projects visible to current user",
+            opts: {
+                team: "team slug (required)",
+                backend: "backend name in rc",
+            },
+            sub: {
+                list: "List projects I have membership in",
+            },
+        },
+        admin: {
+            desc: "Admin commands (user / token / team / member / project)",
+            opts: {},
+        },
+        config: {
+            desc: "Manage ~/.prdrc",
+            opts: {},
+            sub: {
+                show: "Print current ~/.prdrc (token masked)",
+                set: "Update a ~/.prdrc field",
+                use: "Switch default backend",
+            },
+        },
+    },
+};
+//# sourceMappingURL=help.en.js.map

package/dist/i18n/help.en.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.en.js","sourceRoot":"","sources":["../../src/i18n/help.en.ts"],"names":[],"mappings":"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"}

package/dist/i18n/help.js

@@ -0,0 +1,7 @@
+import zh from "./help.zh.js";
+import en from "./help.en.js";
+const helpMaps = { zh, en };
+export function getHelp(locale) {
+    return helpMaps[locale];
+}
+//# sourceMappingURL=help.js.map

package/dist/i18n/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/i18n/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,cAAc,CAAC;AAC9B,OAAO,EAAE,MAAM,cAAc,CAAC;AAG9B,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,EAAE,EAAW,CAAC;AACrC,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/i18n/help.zh.d.ts

@@ -0,0 +1,149 @@
+declare const _default: {
+    program_desc: string;
+    program_lang_opt: string;
+    group: {
+        lifecycle: string;
+        auth: string;
+        sync: string;
+        team: string;
+        admin: string;
+    };
+    cmd: {
+        init: {
+            desc: string;
+            opts: {
+                workspace: string;
+                team: string;
+                project: string;
+                backend: string;
+            };
+        };
+        freeze: {
+            desc: string;
+            opts: {
+                version: string;
+                auto: string;
+            };
+        };
+        context: {
+            desc: string;
+            opts: {
+                feature: string;
+                version: string;
+                working: string;
+                includeQuestions: string;
+                out: string;
+            };
+        };
+        diff: {
+            desc: string;
+            opts: {
+                feature: string;
+                from: string;
+                to: string;
+            };
+        };
+        refresh: {
+            desc: string;
+            opts: {
+                feature: string;
+                newPrd: string;
+                prdAnchor: string;
+                prdAnchorExact: string;
+                out: string;
+                format: string;
+            };
+        };
+        validate: {
+            desc: string;
+            opts: {
+                feature: string;
+            };
+        };
+        "migrate-yaml": {
+            desc: string;
+            opts: {
+                team: string;
+                project: string;
+                nonInteractive: string;
+                backend: string;
+            };
+        };
+        push: {
+            desc: string;
+            opts: {
+                backend: string;
+                allowCreate: string;
+                skipFrozen: string;
+            };
+        };
+        pull: {
+            desc: string;
+            opts: {
+                backend: string;
+                stash: string;
+                force: string;
+            };
+        };
+        status: {
+            desc: string;
+            opts: {
+                backend: string;
+            };
+        };
+        login: {
+            desc: string;
+            opts: {
+                backend: string;
+                url: string;
+                bootstrap: string;
+                admin: string;
+            };
+        };
+        logout: {
+            desc: string;
+            opts: {
+                backend: string;
+            };
+        };
+        whoami: {
+            desc: string;
+            opts: {
+                backend: string;
+            };
+        };
+        team: {
+            desc: string;
+            opts: {
+                backend: string;
+            };
+            sub: {
+                list: string;
+            };
+        };
+        project: {
+            desc: string;
+            opts: {
+                team: string;
+                backend: string;
+            };
+            sub: {
+                list: string;
+            };
+        };
+        admin: {
+            desc: string;
+            opts: {};
+        };
+        config: {
+            desc: string;
+            opts: {};
+            sub: {
+                show: string;
+                set: string;
+                use: string;
+            };
+        };
+    };
+};
+export default _default;

package/dist/i18n/help.zh.js

@@ -0,0 +1,150 @@
+import { SCHEMA_VERSION_CURRENT } from "../schema/prd.js";
+export default {
+    program_desc: `PRD Improve CLI — schema ${SCHEMA_VERSION_CURRENT}`,
+    program_lang_opt: "输出语言 zh | en,放命令前(优先级 flag > PRD_LANG > config > 默认 zh)",
+    group: {
+        lifecycle: "生命周期(离线)",
+        auth: "认证 / 会话",
+        sync: "后端同步",
+        team: "团队 / 项目",
+        admin: "管理 / 配置",
+    },
+    cmd: {
+        init: {
+            desc: "初始化 .prd/ 工作区;传 slug 时同时建 v0.2 yaml(meta.team/project 由 --team/--project 或 .prdrc default_team/default_project 取)",
+            opts: {
+                workspace: "指定 workspace 名称(默认从当前目录名推断)",
+                team: "v1.1 team slug(slug arg 在场时必填,fallback ~/.prdrc default_team)",
+                project: "v1.1 project slug(slug arg 在场时必填,fallback ~/.prdrc default_project)",
+                backend: "rc backend 名(影响 default_team / default_project 取哪个 backend 的值)",
+            },
+        },
+        freeze: {
+            desc: "冻结当前 working/prd.yaml 为不可变快照",
+            opts: {
+                version: "版本号 vX.Y[.Z]",
+                auto: "自动取最大版本+1",
+            },
+        },
+        context: {
+            desc: "渲染 PRD 为精简 Markdown 给 coding agent",
+            opts: {
+                feature: "feature slug(必填)",
+                version: "读指定 frozen 版本 vX.Y[.Z]",
+                working: "读 working/prd.yaml(与 --version 互斥)",
+                includeQuestions: "包含 open_questions 模块",
+                out: "写到文件而非 stdout",
+            },
+        },
+        diff: {
+            desc: "对比两版 PRD(语义级 ID 视角)",
+            opts: {
+                feature: "feature slug(必填)",
+                from: "起点 ref(working / vX.Y[.Z]),默认 latest_frozen",
+                to: "终点 ref(working / vX.Y[.Z]),默认 working",
+            },
+        },
+        refresh: {
+            desc: "产 refresh 索引视图(yaml 索引 + refers_to 反向图 + 可选 PRD 锚点切片)",
+            opts: {
+                feature: "feature slug(必填)",
+                newPrd: "新 PRD 文件路径(仅用于 anchor 切片)",
+                prdAnchor: "PRD 中的 heading 文本(支持完整 / 前缀 / substring)",
+                prdAnchorExact: "锚点严格精确匹配(关闭 prefix / substring fallback)",
+                out: "输出到文件(默认 stdout)",
+                format: "输出格式 md | json",
+            },
+        },
+        validate: {
+            desc: "校验 PRD 文件(中文默认;PRD_LANG=en 切英文)",
+            opts: {
+                feature: "只校验指定 feature",
+            },
+        },
+        "migrate-yaml": {
+            desc: "升级 yaml v0.1 → v0.2(写 meta.team / meta.project)",
+            opts: {
+                team: "team slug,覆盖 ~/.prdrc default_team",
+                project: "project slug,覆盖 ~/.prdrc default_project",
+                nonInteractive: "禁用交互提示;要求 --team 和 --project 显式传入",
+                backend: "选择 ~/.prdrc 中的 backend",
+            },
+        },
+        push: {
+            desc: "推送 working/prd.yaml 到 backend",
+            opts: {
+                backend: "选择 ~/.prdrc 中的 backend",
+                allowCreate: "允许创建 backend 上尚不存在的 feature",
+                skipFrozen: "跳过 frozen 版本同步",
+            },
+        },
+        pull: {
+            desc: "拉取 backend 最新到 working/prd.yaml",
+            opts: {
+                backend: "选择 ~/.prdrc 中的 backend",
+                stash: "脏 working 时把本地存到 .prd/.conflicts/ 再 fast-forward",
+                force: "覆盖本地未提交改动",
+            },
+        },
+        status: {
+            desc: "查看 sync 状态",
+            opts: {
+                backend: "选择 ~/.prdrc 中的 backend",
+            },
+        },
+        login: {
+            desc: "登录 backend(取 token 写 ~/.prdrc)",
+            opts: {
+                backend: "rc 中的 backend 名(默认 'default')",
+                url: "backend URL",
+                bootstrap: "使用 bootstrap secret(否则用 admin token)",
+                admin: "显式 admin token 登录(默认行为)",
+            },
+        },
+        logout: {
+            desc: "登出 backend(吊销 token + 删本地)",
+            opts: {
+                backend: "rc 中的 backend 名",
+            },
+        },
+        whoami: {
+            desc: "显示当前登录身份",
+            opts: {
+                backend: "rc 中的 backend 名",
+            },
+        },
+        team: {
+            desc: "查询当前 user 在 backend 可见的 team",
+            opts: {
+                backend: "rc 中的 backend 名",
+            },
+            sub: {
+                list: "列出我能看见的 team",
+            },
+        },
+        project: {
+            desc: "查询当前 user 在 backend 可见的 project",
+            opts: {
+                team: "team slug(必填)",
+                backend: "rc 中的 backend 名",
+            },
+            sub: {
+                list: "列出我能看见的 project",
+            },
+        },
+        admin: {
+            desc: "管理员命令(user / token / team / member / project)",
+            opts: {},
+        },
+        config: {
+            desc: "管理 ~/.prdrc",
+            opts: {},
+            sub: {
+                show: "打印当前 ~/.prdrc(token 脱敏)",
+                set: "修改 ~/.prdrc 字段",
+                use: "切换默认 backend",
+            },
+        },
+    },
+};
+//# sourceMappingURL=help.zh.js.map

package/dist/i18n/help.zh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.zh.js","sourceRoot":"","sources":["../../src/i18n/help.zh.ts"],"names":[],"mappings":"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"}

package/dist/i18n/helpFormat.d.ts

@@ -0,0 +1,7 @@
+import { Help } from "commander";
+/**
+ * commander v12.1 无 native 命令分组(helpGroup 是 v13+),用 configureHelp
+ * 覆盖 formatHelp 自定义渲染。仅顶层 `prd` 走分组;子命令(admin / team / ...)
+ * 回退 commander 默认 formatter 不动。
+ */
+export declare function makeGroupedHelp(): Partial<Help>;

package/dist/i18n/helpFormat.js

@@ -0,0 +1,51 @@
+import { Help } from "commander";
+import { COMMAND_GROUPS, GROUP_ORDER } from "./helpGroups.js";
+import { getHelp } from "./help.js";
+import { readLocale } from "./index.js";
+/**
+ * commander v12.1 无 native 命令分组(helpGroup 是 v13+),用 configureHelp
+ * 覆盖 formatHelp 自定义渲染。仅顶层 `prd` 走分组;子命令(admin / team / ...)
+ * 回退 commander 默认 formatter 不动。
+ */
+export function makeGroupedHelp() {
+    return {
+        formatHelp(cmd, helper) {
+            // 子命令(cmd.name() !== "prd")用 commander 默认渲染
+            if (cmd.name() !== "prd") {
+                return Help.prototype.formatHelp.call(helper, cmd, helper);
+            }
+            const h = getHelp(readLocale());
+            const pad = helper.padWidth(cmd, helper);
+            const usage = `Usage: ${helper.commandUsage(cmd)}\n\n${cmd.description()}\n`;
+            const opts = helper
+                .visibleOptions(cmd)
+                .map((o) => `  ${helper.optionTerm(o).padEnd(pad)}  ${helper.optionDescription(o)}`)
+                .join("\n");
+            const byGroup = {
+                lifecycle: [],
+                auth: [],
+                sync: [],
+                team: [],
+                admin: [],
+            };
+            for (const sub of helper.visibleCommands(cmd)) {
+                const g = COMMAND_GROUPS[sub.name()];
+                if (g)
+                    byGroup[g].push(sub);
+            }
+            const cmdsSection = GROUP_ORDER.map((g) => {
+                const list = byGroup[g];
+                if (!list.length)
+                    return "";
+                const lines = list
+                    .map((s) => `  ${helper.subcommandTerm(s).padEnd(pad)}  ${helper.subcommandDescription(s)}`)
+                    .join("\n");
+                return `${h.group[g]}:\n${lines}`;
+            })
+                .filter(Boolean)
+                .join("\n\n");
+            return `${usage}\nOptions:\n${opts}\n\nCommands:\n${cmdsSection}\n`;
+        },
+    };
+}
+//# sourceMappingURL=helpFormat.js.map

package/dist/i18n/helpFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpFormat.js","sourceRoot":"","sources":["../../src/i18n/helpFormat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAiB,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,UAAU,CAAC,GAAY,EAAE,MAAY;YACnC,4CAA4C;YAC5C,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAEzC,MAAM,KAAK,GAAG,UAAU,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC;YAE7E,MAAM,IAAI,GAAG,MAAM;iBAChB,cAAc,CAAC,GAAG,CAAC;iBACnB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAC1E;iBACA,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,MAAM,OAAO,GAAgC;gBAC3C,SAAS,EAAE,EAAE;gBACb,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,EAAE;gBACR,KAAK,EAAE,EAAE;aACV,CAAC;YACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrC,IAAI,CAAC;oBAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI;qBACf,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAClF;qBACA,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;YACpC,CAAC,CAAC;iBACC,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,MAAM,CAAC,CAAC;YAEhB,OAAO,GAAG,KAAK,eAAe,IAAI,kBAAkB,WAAW,IAAI,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/i18n/helpGroups.d.ts

@@ -0,0 +1,3 @@
+export type GroupKey = "lifecycle" | "auth" | "sync" | "team" | "admin";
+export declare const COMMAND_GROUPS: Record<string, GroupKey>;
+export declare const GROUP_ORDER: GroupKey[];

package/dist/i18n/helpGroups.js

@@ -0,0 +1,11 @@
+export const COMMAND_GROUPS = {
+    init: "lifecycle", freeze: "lifecycle", context: "lifecycle",
+    diff: "lifecycle", refresh: "lifecycle", validate: "lifecycle",
+    "migrate-yaml": "lifecycle",
+    login: "auth", logout: "auth", whoami: "auth",
+    push: "sync", pull: "sync", status: "sync",
+    team: "team", project: "team",
+    admin: "admin", config: "admin",
+};
+export const GROUP_ORDER = ["lifecycle", "auth", "sync", "team", "admin"];
+//# sourceMappingURL=helpGroups.js.map

package/dist/i18n/helpGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpGroups.js","sourceRoot":"","sources":["../../src/i18n/helpGroups.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW;IAC5D,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW;IAC9D,cAAc,EAAE,WAAW;IAC3B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC7C,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC1C,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAC7B,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * i18n key 命名约定(团队共识,新增 key 时遵守):
+ *
+ * 1. snake_case —— 全小写 + 下划线分隔
+ * 2. 语义动词在前 —— missing_* / duplicate_* / reference_* / unsupported_* / schema_*
+ * 3. key === ValidationIssue.code(一一对应)
+ * 4. 占位符通过 details 对象传入,函数式渲染:`(d) => "...${d.x}..."`
+ * 5. zh.ts 与 en.ts 必须 key 集合完全一致(测试会断言)
+ */
+import zh from "./zh.js";
+export type Locale = "zh" | "en";
+export type MessageMap = typeof zh;
+export declare function resolveLang(flagValue?: string): Locale;
+export declare function setLocale(flagValue?: string): void;
+export declare function readLocale(): Locale;
+export declare function getMessages(locale: Locale): MessageMap;

package/dist/i18n/index.js

@@ -0,0 +1,46 @@
+/**
+ * i18n key 命名约定(团队共识,新增 key 时遵守):
+ *
+ * 1. snake_case —— 全小写 + 下划线分隔
+ * 2. 语义动词在前 —— missing_* / duplicate_* / reference_* / unsupported_* / schema_*
+ * 3. key === ValidationIssue.code(一一对应)
+ * 4. 占位符通过 details 对象传入,函数式渲染:`(d) => "...${d.x}..."`
+ * 5. zh.ts 与 en.ts 必须 key 集合完全一致(测试会断言)
+ */
+import zh from "./zh.js";
+import en from "./en.js";
+import { loadRc } from "../config/rc.js";
+const maps = { zh, en };
+function normalizeLang(raw) {
+    const v = raw.trim().toLowerCase().replace(/_/g, "-");
+    if (v === "en" || v.startsWith("en-") || v === "english")
+        return "en";
+    if (v === "zh" || v.startsWith("zh-") || v === "cn" || v === "chinese")
+        return "zh";
+    return "zh"; // unknown → silent fallback
+}
+function readRcLang() {
+    try {
+        const r = loadRc();
+        return r.ok ? r.rc.lang : undefined;
+    }
+    catch {
+        return undefined; // rc 坏不破坏 CLI
+    }
+}
+export function resolveLang(flagValue) {
+    const candidate = flagValue ?? process.env.PRD_LANG ?? readRcLang() ?? "zh";
+    return normalizeLang(candidate);
+}
+let resolvedLocale;
+// flagValue 有值 → 锁定;falsy(含 undefined)→ reset 到"现算"模式
+export function setLocale(flagValue) {
+    resolvedLocale = flagValue ? resolveLang(flagValue) : undefined;
+}
+export function readLocale() {
+    return resolvedLocale ?? resolveLang();
+}
+export function getMessages(locale) {
+    return maps[locale];
+}
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAIzC,MAAM,IAAI,GAA+B,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AAEpD,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,IAAI,CAAC,CAAC,4BAA4B;AAC3C,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,EAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,CAAC,cAAc;IAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAkB;IAC5C,MAAM,SAAS,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,UAAU,EAAE,IAAI,IAAI,CAAC;IAC5E,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,cAAkC,CAAC;AACvC,sDAAsD;AACtD,MAAM,UAAU,SAAS,CAAC,SAAkB;IAC1C,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,IAAI,WAAW,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC"}

package/dist/i18n/peekLang.d.ts

@@ -0,0 +1 @@
+export declare function peekLangArg(argv: string[]): string | undefined;

package/dist/i18n/peekLang.js

@@ -0,0 +1,16 @@
+// Scan argv for --lang <v> / --lang=<v>, position-independent.
+// Used before commander.parse() (help render) + as flag fallback.
+export function peekLangArg(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--lang") {
+            const next = argv[i + 1];
+            return next && !next.startsWith("-") ? next : undefined;
+        }
+        if (a.startsWith("--lang=")) {
+            return a.slice("--lang=".length) || undefined;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=peekLang.js.map

package/dist/i18n/peekLang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peekLang.js","sourceRoot":"","sources":["../../src/i18n/peekLang.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}