@oj-module/cli 0.2.23 → 0.2.25

package/templates/README.md

@@ -7,7 +7,7 @@
 ```bash
 pnpm install
 pnpm dev        # 开发：前端 devServer + oj 后端（api/src 保存即热更）
-pnpm build      # 构建：oj build + 前端全站合并到 web/dist
+pnpm build      # 构建：oj build + 前端全站合并到 dist/web
 pnpm preview    # 预览：oj migrate + server（release 产物）
 ```
 
@@ -35,9 +35,9 @@ pnpm exec ojm api                     # 重新生成 web/src/*/__client（dev
 ```
 bin/           oj 二进制（init 解压，不入库）
 api/src/       后端模块源码（目录镜像路由：api/src/<模块>/<路径>/api.ts）
-api/dist/      oj build 产物
+dist/api/      oj build 产物
 web/src/   前端模块源码
-web/dist/  构建产物（完整站点）
+dist/web/  构建产物（完整站点）
 ```
 
 ## 注意

package/templates/cdn/README.md

@@ -1,8 +1,8 @@
 # cdn/ —— 本地模拟市场源
 
-本目录是**本地模拟 CDN**：`ojm market publish` 把分发包落在这里，站点通过 `api/config.yaml` 里的挂载
-（`- prefix: /cdn` → `web: ../cdn`）把它直出成分发源，市场页按系统设置 `framework.market_cdn_url`
-指向的地址读取。
+本目录是**本地模拟 CDN**：`ojm market publish` 把分发包落在这里，站点通过工程根 `config.yaml` 里的挂载
+（`- prefix: /cdn` → `web: ./cdn`）把它直出成分发源。市场按系统设置 `framework.market_cdn_url` 读取，
+**seed 缺省值即相对路径 `/cdn`（本站点自供），新工程免 `ojm market setup`**；指向外部真 CDN 时才改设置。
 
 > **目录缺失会让站点起不来**：`oj serve` 启动即校验挂载目录，缺失就报错退出。
 > 所以本 README 进模板、进发布包、进新工程——它的存在就是目录存在的理由，**不要删**。
@@ -23,14 +23,14 @@
 
 ## 生产怎么切出去
 
-1. 删掉 `api/config.yaml` 的 `mounts` 里这条（它就是本地挂载的全部）：
+1. 删掉工程根 `config.yaml` 的 `mounts` 里这条（它就是本地挂载的全部）：
 
 ```yaml
   - prefix: /cdn
-    web: ../cdn
+    web: ./cdn
 ```
 
-2. 把真 CDN（对象存储 / nginx）的地址写进系统设置 `framework.market_cdn_url`；
+2. 把真 CDN（对象存储 / nginx）的**绝对地址**写进系统设置 `framework.market_cdn_url`；
    命令行等价写法是 `ojm market setup --url <地址>`。
 3. 索引（`bundles.yaml` / `manifests.yaml`）由 CDN 侧维护：`ojm market build-index` 在本地产出后自行上传。
 

package/templates/config.yaml

@@ -30,19 +30,20 @@
 # **这里没有 api 挂载是有意的**：本工程是 `src/<name>/{api,web}` 布局，模块分散在
 # `src/<name>/api` 下，而 mounts 的 api 项按 `<目录>/<模块>/manifest.yaml` 单层解析、
 # 不会递归（实测报 `module 'x' missing manifest.yaml`）。源码形态由 `ojm dev` 用
-# `--module-root src` 供给，产物形态由 `ojm preview` 用 `--api-path api/dist` 供给；
+# `--module-root src` 供给，产物形态由 `ojm preview` 用 `--api-path dist/api` 供给；
 # 两者与 mounts 的 api 项同时出现还会报「module declared in multiple places」。
 # 手写部署（不经 ojm）时才需要自己加回一条 `- prefix: /api` + `api: dist`。
 mounts:
   # 本地模拟 CDN：直出工程根 cdn/（内容见 cdn/README.md）。
-  # 红线：生产请删掉这一条挂载，并把 system 设置 framework.market_cdn_url 指向真 CDN。
+  # seed 的 framework.market_cdn_url 缺省即 /cdn（本站点自供），新工程免 market setup。
+  # 红线：生产请删掉这一条挂载，并把 system 设置 framework.market_cdn_url 指向真 CDN（绝对地址）。
   # 不得给此挂载设 spa——缺文件必须返回 404，回落 index.html 会让市场解析崩。
   - prefix: /cdn
     web: ./cdn
   # 生产若由 oj 直出前端（前后端同进程，即 ojm preview 的生产形态），
-  # 取消下一行注释并先 build 出 web/dist（preview 会自动注入等价挂载，无需手改）：
+  # 取消下一行注释并先 build 出 dist/web（preview 会自动注入等价挂载，无需手改）：
   # - prefix: "/"
-  #   web: "./web/dist"   # 相对 config.yaml → 工程根/web/dist
+  #   web: "./dist/web"   # 相对 config.yaml → 工程根/dist/web
   #   spa: true
   # 嵌套 handler 组（oj v0.1.64）无需配置开关，组织方式见 api.ts 顶部注释。
 

package/templates/init.include.yaml

@@ -8,7 +8,7 @@
 #  2. 模板自运行专属文件——templates 本身也是一个可 `pnpm dev` 的工程，
 #     它的 package.json / node_modules / bin / lock 绝不能泄漏进用户工程；
 #     package.json 由 init 现场生成（钉死真实版本，不带 workspace:/catalog:）。
-#  3. 构建与运行期产物——api/dist、web/dist、logs、签发的私钥与 sqlite；
+#  3. 构建与运行期产物——dist/api、dist/web、logs、签发的私钥与 sqlite；
 #     模板跑过 build/dev 后会留在本地，既不进用户工程，更不该让所有工程
 #     共享同一把私钥。
 #  4. 模板自用元数据——本清单自身。

package/templates/seed.mysql.sql

@@ -1,5 +1,6 @@
 -- 系统设置默认值（PRD §4.3；注释内禁英文分号）
 INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('framework.site_title', 'framework', 'general', 'string', 'React Antd Admin', 'React Antd Admin', 'system:setting.site_title', 0, 0);
-INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '', '', 'system:setting.market_cdn_url', 0, 0);
+-- 系统设置默认值（PRD §4.3；注释内禁英文分号；framework.market_cdn_url 缺省 /cdn = 本站点自供，免 setup）
+INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '/cdn', '/cdn', 'system:setting.market_cdn_url', 0, 0);
 INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('ldap.enabled', 'ldap', 'login', 'bool', '0', '0', 'system:setting.ldap_enabled', 0, 0);
 INSERT IGNORE INTO sys_setting (key, module, `group`, type, value, default_value, label_key, secret, update_time) VALUES ('sso.enabled', 'sso', 'login', 'bool', '0', '0', 'system:setting.sso_enabled', 0, 0);

package/templates/seed.pg.sql

@@ -1,5 +1,6 @@
 -- 系统设置默认值（PRD §4.3；注释内禁英文分号）
 INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.site_title', 'framework', 'general', 'string', 'React Antd Admin', 'React Antd Admin', 'system:setting.site_title', 0, 0) ON CONFLICT DO NOTHING;
-INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '', '', 'system:setting.market_cdn_url', 0, 0) ON CONFLICT DO NOTHING;
+-- 系统设置默认值（PRD §4.3；注释内禁英文分号；framework.market_cdn_url 缺省 /cdn = 本站点自供，免 setup）
+INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '/cdn', '/cdn', 'system:setting.market_cdn_url', 0, 0) ON CONFLICT DO NOTHING;
 INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('ldap.enabled', 'ldap', 'login', 'bool', '0', '0', 'system:setting.ldap_enabled', 0, 0) ON CONFLICT DO NOTHING;
 INSERT INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('sso.enabled', 'sso', 'login', 'bool', '0', '0', 'system:setting.sso_enabled', 0, 0) ON CONFLICT DO NOTHING;

package/templates/src/_platform/api/market/api.ts

@@ -87,7 +87,7 @@ export interface MarketEnv {
 
 /**
  * 宿主 versions.json 布局推导（B-11）：与 manifests.yaml 同层（release 根 = `sharedRoot`），
- * 不是站点产物根——两处根在 `src/<name>/{api,web}` 布局下已分流（`api/dist` vs `web/dist`）。
+ * 不是站点产物根——两处根在 `src/<name>/{api,web}` 布局下已分流（`dist/api` vs `dist/web`）。
  */
 export function versionsJsonPathOf(releaseRoot: string): string {
 	const trimmed = releaseRoot.replace(/\/+$/, "");
@@ -132,21 +132,22 @@ async function hostVersionsOf(env: MarketEnv): Promise<Record<string, string> |
 /**
  * oj serve release 布局生产缺省（P1-16 B3/B4；全字段可覆盖）。
  *
- * 两处根在 `src/<name>/{api,web}` 布局下分流，且都相对 fs jail 根（= config.yaml 所在目录）：
- *   release 根 `api/dist` —— 版本目录 / manifests.yaml / versions.json / migrations（后端产物）
- *   站点根   `web/dist`   —— modules/ + modules.json（前端产物，安装器 upsert 的落点）
+ * 两处根在 `src/<name>/{api,web}` 布局下分流（2026-10-22 起收进工程根 dist/），
+ * 且都相对 fs jail 根（= config.yaml 所在目录）：
+ *   release 根 `dist/api` —— 版本目录 / manifests.yaml / versions.json / migrations（后端产物）
+ *   站点根   `dist/web`   —— modules/ + modules.json（前端产物，安装器 upsert 的落点）
  * 暂存 / 任务 / 状态 / 信任库 / db 仍在 jail 根下：它们是安装器私有面，不属任何产物根。
  */
 export function marketEnv(): MarketEnv {
 	return {
-		sharedRoot: "api/dist",
+		sharedRoot: "dist/api",
 		staging: "modules/.staging",
 		taskDir: "modules/.install-tasks",
 		statePath: "modules/.solutions/state.yaml",
 		trustPath: ".solutions/trusted-keys.yaml",
 		dbPath: "db.sqlite",
-		siteModulesDir: "web/dist/modules",
-		modulesJsonPath: "web/dist/modules.json",
+		siteModulesDir: "dist/web/modules",
+		modulesJsonPath: "dist/web/modules.json",
 		apiPrefix: "/api",
 		ledgerHeadOf: journalHeadOf,
 	};
@@ -162,7 +163,9 @@ function fail(status: number, msg: string): never {
 }
 
 function fetchOf(env: MarketEnv): FetchInitFace {
-	return env.fetch ?? (globalThis as { fetch?: FetchInitFace }).fetch as FetchInitFace;
+	// 相对基址（feature：/cdn = 本站点自供）按请求源补全同源绝对 URL；绝对 http(s) 直通。
+	// 无请求上下文（无 Host）不猜原点、原样透传；runInstall 侧的 withSiteOrigin 包裹幂等。
+	return withSiteOrigin(env.fetch ?? (globalThis as { fetch?: FetchInitFace }).fetch as FetchInitFace);
 }
 
 function execOf(env: MarketEnv): ExecFace {

package/templates/src/_platform/api/seed.sql

@@ -23,8 +23,9 @@ INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'admin' FROM
 INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'editor' FROM users WHERE username = 'editor';
 INSERT OR IGNORE INTO sys_user_role (user_id, role_name) SELECT id, 'viewer' FROM users WHERE username = 'viewer';
 -- 系统设置默认值（PRD §4.3；C4 设置页 / C5 登录方式发现的数据源；framework.market_cdn_url 安全组仅 superadmin 可改）
+-- framework.market_cdn_url 缺省 /cdn = 本站点自供（config.yaml 的 /cdn 挂载直出工程根 cdn/），脚手架免 setup；外部真 CDN 才改指绝对地址
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.site_title', 'framework', 'general', 'string', 'React Antd Admin', 'React Antd Admin', 'system:setting.site_title', 0, 0);
-INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '', '', 'system:setting.market_cdn_url', 0, 0);
+INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('framework.market_cdn_url', 'framework', 'security', 'string', '/cdn', '/cdn', 'system:setting.market_cdn_url', 0, 0);
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('ldap.enabled', 'ldap', 'login', 'bool', '0', '0', 'system:setting.ldap_enabled', 0, 0);
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('sso.enabled', 'sso', 'login', 'bool', '0', '0', 'system:setting.sso_enabled', 0, 0);
 INSERT OR IGNORE INTO sys_setting (key, module, "group", type, value, default_value, label_key, secret, update_time) VALUES ('ldap_base_dn', 'ldap', 'ldap', 'string', '', '', 'system:setting.ldap_base_dn', 0, 0);

package/templates/src/_platform/api/solutions/api.ts

@@ -37,9 +37,9 @@ export type { SolutionRouteRow } from "../_lifecycle/verify-checks";
  */
 export function solutionsEnv(): SolutionsEnv {
 	return {
-		sharedRoot: "api/dist",
+		sharedRoot: "dist/api",
 		statePath: "modules/.solutions/state.yaml",
-		modulesJsonPath: "web/dist/modules.json",
+		modulesJsonPath: "dist/web/modules.json",
 		apiPrefix: "/api",
 	};
 }

package/templates/src/system/web/pages/users/roles.tsx

@@ -7,7 +7,7 @@ import { useTranslation } from "react-i18next";
 import { useNavigate, useParams } from "react-router";
 
 import { systemRolesGet, systemUsersGet, systemUsersRolesPut } from "../../__client/api";
-import { isForbidden } from "../errors";
+import { explainError, isForbidden } from "../errors";
 import { ForbiddenPanel } from "../forbidden";
 
 /**
@@ -36,6 +36,8 @@ export default function UserRolesPage() {
 			queryClient.invalidateQueries({ queryKey: ["system", "users"] });
 			navigate("/system/users");
 		},
+		// 403 全局 toast 已被请求层抑制，页面须自行反馈（admin 非 superadmin 手输 URL 的场景）
+		onError: e => message.error(explainError(e, t)),
 	});
 
 	const user = usersQuery.data?.find(u => String(u.id) === uid);

package/templates/tests/lifecycle/market-api.spec.ts

@@ -331,6 +331,36 @@ describe("POST install（cdn：Form B 索引解析属市场侧，安装器不拼
 	});
 });
 
+describe("相对基址（feature：/cdn = 本站点自供，按请求源补全同源绝对 URL）", () => {
+	const REL = "/cdn";
+	const HOST = "127.0.0.1:9778";
+	const relEnv = () => makeEnv({ cdnBase: async () => REL });
+
+	it("index：索引与 .sig/manifests 拉取按请求 Host 补全为同源绝对 URL", async () => {
+		const api = createMarketApi(relEnv());
+		g.http = { user: { id: 1 }, headers: { host: HOST } };
+		await api.index.get();
+		expect(last?.status).toBe(200);
+		expect(fetchCalls).toContain(`http://${HOST}/cdn/bundles.yaml`);
+		expect(fetchCalls).toContain(`http://${HOST}/cdn/manifests.yaml`);
+	});
+
+	it("install：archive 分发包同样补全同源绝对 URL", async () => {
+		const api = createMarketApi(relEnv());
+		g.http = { user: { id: 1 }, body: { name: "demo-solution", version: "0.1.0", source: "cdn" }, headers: { host: HOST } };
+		await api.install.post();
+		expect(last?.status).toBe(200);
+		expect(fetchCalls).toContain(`http://${HOST}/cdn/demo-solution-0.1.0.tgz`);
+	});
+
+	it("无请求上下文（无 Host）：不猜原点，原样透传相对 URL", async () => {
+		const api = createMarketApi(relEnv());
+		g.http = { user: { id: 1 } };
+		await api.index.get();
+		expect(fetchCalls).toContain("/cdn/bundles.yaml");
+	});
+});
+
 describe("POST install/cancel（P3-12 端点接线，U5/P3-8 令牌的消费面）", () => {
 	it("无进行中安装 → 404（取消只对 running 态有效，任务终态后信号已注销）", async () => {
 		const api = createMarketApi(makeEnv());
@@ -858,12 +888,12 @@ describe("hostVersions 缺省接线（B-11：C2-09 比对真源 = <dist>/version
 });
 
 describe("P1-16 接线：marketEnv 生产口径 / exec opts 转发 / operator 通道 / 账本真源 / index 即对账入口", () => {
-	it("marketEnv() 缺省 = 布局 v2 生产口径：版本目录与 versions.json 在 release 根 api/dist，站点 modules 在 web/dist；暂存/任务/sidecar 留 jail 根", () => {
+	it("marketEnv() 缺省 = 布局 v3 生产口径：版本目录与 versions.json 在 release 根 dist/api，站点 modules 在 dist/web；暂存/任务/sidecar 留 jail 根", () => {
 		const env = marketEnv();
-		expect(env.sharedRoot).toBe("api/dist");
-		expect(env.siteModulesDir).toBe("web/dist/modules");
-		expect(env.modulesJsonPath).toBe("web/dist/modules.json");
-		expect(versionsJsonPathOf(env.sharedRoot)).toBe("api/dist/versions.json");
+		expect(env.sharedRoot).toBe("dist/api");
+		expect(env.siteModulesDir).toBe("dist/web/modules");
+		expect(env.modulesJsonPath).toBe("dist/web/modules.json");
+		expect(versionsJsonPathOf(env.sharedRoot)).toBe("dist/api/versions.json");
 		expect(env.staging).toBe("modules/.staging");
 		expect(env.taskDir).toBe("modules/.install-tasks");
 		expect(env.statePath).toBe("modules/.solutions/state.yaml");

package/templates/tests/lifecycle/verify-checks.spec.ts

@@ -278,7 +278,7 @@ function setHttp(over: Record<string, unknown>) {
 }
 
 function makeEnv() {
-	// modulesJsonPath 钉进临时目录（readFile 失败 → 不打 web 项）：默认值 `web/dist/modules.json`
+	// modulesJsonPath 钉进临时目录（readFile 失败 → 不打 web 项）：默认值 `dist/web/modules.json`
 	// 是相对 cwd 的，会把模板本机构建产物卷进用例，全绿用例随「模板 build 过没有」摇摆。
 	// P4-2 两条 integrity 用例显式覆盖它。
 	return { ...solutionsEnv(), sharedRoot: root, statePath: join(root, "state.yaml"), modulesJsonPath: join(root, "modules.json") };

package/templates/tests/lifecycle/verify-report.spec.ts

@@ -128,7 +128,7 @@ function setHttp(over: Record<string, unknown> = {}) {
 
 function makeEnv() {
 	// modulesJsonPath 同 verify-checks.spec：钉进临时目录（缺文件 → 跳过 web 项），
-	// 不吃模板本机 `web/dist/modules.json`。
+	// 不吃模板本机 `dist/web/modules.json`。
 	return { ...solutionsEnv(), sharedRoot: root, statePath: join(root, "state.yaml"), modulesJsonPath: join(root, "modules.json"), verifyReportsDir: reportsDir };
 }
 

package/vendor/host-versions.json

@@ -8,9 +8,9 @@
 		"react-router": "7.18.2",
 		"react-router/dom": "7.18.2",
 		"@tanstack/react-query": "5.102.8",
-		"@oj-module/runtime": "0.2.23",
-		"@oj-module/runtime/contract": "0.2.23",
-		"@oj-module/runtime/contract/errors": "0.2.23",
+		"@oj-module/runtime": "0.2.25",
+		"@oj-module/runtime/contract": "0.2.25",
+		"@oj-module/runtime/contract/errors": "0.2.25",
 		"@plane/kit": "0.1.20",
 		"@plane/editor": "0.1.20",
 		"antd": "6.6.1",

package/src/args.ts

@@ -1,172 +0,0 @@
-/**
- * 子命令参数解析（纯函数，可测）。
- *
- * 约定：位置参数取第一个不以 `--` 开头的参数；`--xxx` 一律是开关/选项。
- * 缺陷背景：`ojm init --yes` 曾把 argv[3]（即 `--yes`）当目标目录。
- */
-
-export function parseInitArgs(argv: string[]): { dest: string, yes: boolean } {
-	const yes = argv.includes("--yes");
-	const dest = argv.find(a => !a.startsWith("--")) ?? "";
-	return { dest, yes };
-}
-
-/**
- * `ojm api [dir] [--check] [--docs] [--exempt <path>]`：位置参数为项目目录
- * （缺省 cwd），与 parseInitArgs 同一约定（docs/prd/202609032019-ojm-api-cwd.md）。
- * 注意：`--exempt` 的「值」不得以 `--` 开头，否则会被误判为 dir——故逐项扫描，
- * 消费掉 `--exempt` 紧随的值，避免被 dir 解析吞噬（P6 同款坑）。
- */
-export function parseApiArgs(argv: string[]): { dir: string, check: boolean, docs: boolean, exempt?: string } {
-	const flags = new Set<string>();
-	const positionals: string[] = [];
-	let exempt: string | undefined;
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i];
-		if (a === "--exempt") {
-			exempt = argv[i + 1];
-			i++; // 跳过紧随的值，不被当 dir
-			continue;
-		}
-		if (a.startsWith("--")) {
-			flags.add(a);
-			continue;
-		}
-		positionals.push(a);
-	}
-	const dir = positionals[0] ?? "";
-	return { dir, check: flags.has("--check"), docs: flags.has("--docs"), exempt };
-}
-
-/**
- * `ojm build [--bundle] [--out <dir>]`。
- * `--bundle`：方案包构建（契约校验 → 确定性 tgz + sha256）。bundle 级契约位置：优先工程根
- * `solution.yaml`、或 `src/<模块>/solution.yaml`（模块级方案，契约与所打包模块同位）；旧方案回退
- * `manifest.yaml`（同两处位置）。与站点级 `ojm build`（后端 oj build + 模块产物合并）互斥分工
- * （devkit 手册「打包与分发」）。
- * `--out` 的值不得以 `--` 开头（同 parseApiArgs 的消费式扫描，P6 同款坑）。
- */
-export function parseBuildArgs(argv: string[]): { bundle: boolean, bundleName?: string, out?: string } {
-	const flags = new Set<string>();
-	let out: string | undefined;
-	let bundleName: string | undefined;
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i];
-		if (a === "--out") {
-			out = argv[i + 1];
-			i++; // 消费紧随的值，不被当 flag
-			continue;
-		}
-		// --bundle <name> / --bundle=<name>：只打这一份方案（无值 = 全部用户方案）
-		if (a === "--bundle") {
-			flags.add(a);
-			const next = argv[i + 1];
-			if (next !== undefined && !next.startsWith("--")) {
-				bundleName = next;
-				i++;
-			}
-			continue;
-		}
-		if (a.startsWith("--bundle=")) {
-			flags.add("--bundle");
-			bundleName = a.slice("--bundle=".length);
-			continue;
-		}
-		if (a.startsWith("--")) {
-			flags.add(a);
-		}
-	}
-	return { bundle: flags.has("--bundle"), bundleName, out };
-}
-
-/**
- * `ojm new <name> [--layout container|none] [--api]`：新方案骨架生成参数。
- * name 为首个非 flag 位置参数（必填，由调用方判空——非交互/CI 友好）。
- */
-export function parseNewArgs(argv: string[]): { name?: string, layout?: "container" | "none", api?: boolean } {
-	let name: string | undefined;
-	let layout: "container" | "none" | undefined;
-	let api = false;
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i];
-		if (a === "--layout") {
-			const v = argv[i + 1];
-			if (v !== "container" && v !== "none")
-				throw new Error(`[ojm] --layout 只接受 container | none（实际：${v}）`);
-			layout = v;
-			i++;
-			continue;
-		}
-		if (a === "--api") {
-			api = true;
-			continue;
-		}
-		if (a !== undefined && !a.startsWith("--")) {
-			if (name !== undefined)
-				throw new Error(`[ojm] ojm new 只接受一个方案名（多余参数：${a}）`);
-			name = a;
-			continue;
-		}
-	}
-	return { name, layout, api };
-}
-
-/**
- * `ojm vendor [tag] [--force]`：下载/更新 oj vendor（npm 包 @oj-bin/oj）。
- * tag 缺省追 npm latest；形如 `v0.1.13` 或 `0.1.13`（自动补 v 前缀，装包时去掉）。
- * 非法 tag 形状即报错（防误把目录当版本）。
- */
-export function parseVendorArgs(argv: string[]): { force: boolean, tag?: string } {
-	const tag = argv.find(a => !a.startsWith("--") && a !== "--");
-	if (tag !== undefined && !/^v?\d+\.\d+\.\d+(?:-[\w.]+)?$/.test(tag)) {
-		throw new Error(`[ojm] 非法版本号：${tag}（形如 v0.1.11 或 0.1.11）`);
-	}
-	return {
-		force: argv.includes("--force"),
-		tag: tag === undefined ? undefined : (tag.startsWith("v") ? tag : `v${tag}`),
-	};
-}
-
-export interface LifecycleArgs {
-	positionals: string[]
-	url?: string
-	user?: string
-	pass?: string
-	locale?: string
-	name?: string
-	version?: string
-	task?: string
-}
-
-/**
- * `ojm install|enable|disable` 共用解析：位置参数（目标/方案名）+ 值式 flag。
- * 站点寻址三件套 --url/--user/--pass（环境变量 OJM_URL/OJM_USER/OJM_PASS 兜底，见 src/site.ts）；
- * install 专属 --name/--version（文件名身份覆盖）与 --locale（终态文案语言）；
- * trust 专属 --task（TOFU 确认目标任务 id，P2-3）。
- * 值式 flag 逐项消费紧随的值，不被当位置参数（P6 同款坑，parseApiArgs 同纪律）。
- */
-export function parseLifecycleArgs(argv: string[]): LifecycleArgs {
-	const valueFlags = new Set(["--url", "--user", "--pass", "--locale", "--name", "--version", "--task"]);
-	const values: Record<string, string> = {};
-	const positionals: string[] = [];
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i]!;
-		if (valueFlags.has(a)) {
-			values[a] = argv[i + 1] ?? "";
-			i++; // 消费紧随的值
-			continue;
-		}
-		if (!a.startsWith("--"))
-			positionals.push(a);
-	}
-	return {
-		positionals,
-		url: values["--url"],
-		user: values["--user"],
-		pass: values["--pass"],
-		locale: values["--locale"],
-		name: values["--name"],
-		version: values["--version"],
-		task: values["--task"],
-	};
-}

package/src/lifecycle/__tests__/args.test.ts

@@ -1,20 +0,0 @@
-// BDD：ojm new 参数解析（统一审查 F8——多余位置参数须显式拒绝，不能静默丢弃）。
-// 静默丢弃的恶果：ojm new crm erp（手滑/粘贴）只建 crm，用户以为两份都建了。
-import { describe, expect, it } from "vitest";
-import { parseNewArgs } from "../../args";
-
-describe("parseNewArgs", () => {
-	it("name + 旗标组合", () => {
-		expect(parseNewArgs(["crm"])).toEqual({ name: "crm", layout: undefined, api: false });
-		expect(parseNewArgs(["crm", "--layout", "none", "--api"])).toEqual({ name: "crm", layout: "none", api: true });
-		expect(parseNewArgs([])).toEqual({ name: undefined, layout: undefined, api: false });
-	});
-
-	it("多余位置参数 → 报错而非静默丢弃", () => {
-		expect(() => parseNewArgs(["crm", "erp"])).toThrow(/只接受一个方案名/);
-	});
-
-	it("非法 --layout 值 → 报错", () => {
-		expect(() => parseNewArgs(["crm", "--layout", "sidebar"])).toThrow(/container \| none/);
-	});
-});