@oj-module/cli 0.2.23 → 0.2.26

package/src/market/bootstrap.ts

@@ -36,7 +36,9 @@ import { parseFixtureSpec } from "./fixture";
 import { publishPackage } from "./publish";
 
 /** 种子管理员（隔离库全新 seed；与 templates seed.sql 一致） */
-const SEED_ADMIN_USER = "admin";
+// 种子管理员 = superadmin：模板 seed 账号名=角色名（3d93063f 起 admin 被幂等解绑 superadmin
+// 角色），写 market 安全设置要求 actor 持 superadmin 角色——用 admin 会 403（2026-10-23 演练实踩）。
+const SEED_ADMIN_USER = "superadmin";
 const SEED_ADMIN_PASS = "123456";
 
 /** Ed25519 PKCS#8 DER 前缀（RFC 8410 固定头；与 gen-signed-fixtures.mjs 同一手法） */
@@ -50,7 +52,7 @@ export interface IsolatedPublisher {
 }
 
 export interface IsolatedSite {
-	/** 临时根（含 config.yaml / src/ / api/dist/ / bin/ / cdn/） */
+	/** 临时根（含 config.yaml / src/ / dist/api/ / bin/ / cdn/） */
 	root: string
 	port: number
 	baseUrl: string
@@ -96,7 +98,7 @@ export async function bootstrapIsolatedSite(opts: BootstrapOptions = {}): Promis
 
 	const root = mkdtempSync(path.join(tmpdir(), "ojm-trial-"));
 	// 新布局（`src/<name>/{api,web}`）：config.yaml 在隔离根，源码树根为 <root>/src，
-	// 构建产物仍是扁平根 <root>/api/dist（与真实工程同形）。
+	// 构建产物仍是扁平根 <root>/dist/api（与真实工程同形）。
 	const srcDir = path.join(root, "src");
 	const configPath = path.join(root, "config.yaml");
 	const cdnDir = path.join(root, "cdn");
@@ -143,9 +145,9 @@ export async function bootstrapIsolatedSite(opts: BootstrapOptions = {}): Promis
 	mkdirSync(siteDir, { recursive: true });
 	writeFileSync(path.join(siteDir, "index.html"), "<!doctype html><html><body>ojm trial site</body></html>\n", "utf-8");
 	cfg = cfg.replace("web: ./cdn", `web: ${cdnDir}\n  - prefix: /\n    web: ${siteDir}\n    spa: true`);
-	// 安装目标恒为 release 部署：装好的模块落在 api/dist，dev 形态（--api-path src）发现不了。
+	// 安装目标恒为 release 部署：装好的模块落在 dist/api，dev 形态（--api-path src）发现不了。
 	// 故隔离站点以 dist 起站，platform.root 同步改写（oj 校验 root 必须是生效的 api 挂载目录）。
-	// root 相对 **config 所在目录** 解析——config 在隔离根，产物在 <root>/api/dist，故不能写死
+	// root 相对 **config 所在目录** 解析——config 在隔离根，产物在 <root>/dist/api，故不能写死
 	// `dist`（那是 config 还在 api/ 时的旧口径），按布局取值。
 	const apiDistRel = path.relative(root, resolveLayout(root).apiDist).split(path.sep).join("/");
 	cfg = cfg.replace("  root: src", `  root: ${apiDistRel}`);
@@ -172,14 +174,14 @@ export async function bootstrapIsolatedSite(opts: BootstrapOptions = {}): Promis
 	await publishPackage({ projectRoot: root, fixture: opts.fixture, id: keyId, privateKeyPem: publisher.privateKeyPem });
 	await buildIndex({ projectRoot: root, id: keyId, privateKeyPem: publisher.privateKeyPem });
 
-	// 7) 后端构建（api/dist + versions.json；安装与 reloading 都依赖它）
+	// 7) 后端构建（dist/api + versions.json；安装与 reloading 都依赖它）
 	await buildBackend(root);
 
 	// 7b) 起 oj（starter 注入供测试）；ready 失败即整体作废，不留孤儿
 	const starter = opts.starter ?? ((cfgPath: string, base: string, apiSrc: string) => startOj(cfgPath, base, apiSrc));
 	let oj: OjProcess;
 	try {
-		oj = starter(configPath, "/api", path.join(root, "api", "dist"));
+		oj = starter(configPath, "/api", resolveLayout(root).apiDist);
 		await oj.ready;
 	}
 	catch (error) {
@@ -258,7 +260,7 @@ function teardownReport(root: string, port: number): string[] {
 		`隔离根：${root}`,
 		"  config.yaml + config/ 证书 + db.sqlite   站点配置面",
 		"  src/    后端模块源码树（src/<name>/api，拷自 cli 内置模板）",
-		"  api/dist/  构建产物（安装目标）",
+		"  dist/api/  构建产物（安装目标）",
 		"  bin/    oj 二进制与插件（拷贝自源工程）",
 		"  cdn/    隔离 CDN（fixture 包 + 两份索引 + 签名）",
 		`监听端口：127.0.0.1:${port}（进程已停）`,

package/src/market/cdn-layout.ts

@@ -3,9 +3,9 @@
  *
  * 两条不能破的规矩：
  * 1. **不许硬编码端口/主机/挂载路径**——全部从 `api/config.yaml` 读。
- *    dev 形态下 `/cdn` 只在 oj 子进程（`server.port`）上成立，dev server 自己（5174）
- *    会把 `/cdn/*` 交给静态层、未命中就回落 index.html（设计 §3.1.1）；写成相对路径或
- *    写死 9778，市场页拿到的会是 HTML 而不是索引 YAML。
+ *    （2026-10-23 起 dev 形态 ojm 已把 /cdn 反代给 oj 子进程，`framework.market_cdn_url`
+ *    允许写相对路径 `/cdn` = 本站点自供，由消费侧按请求源补全；本模块的绝对基址推导
+ *    只服务 `market setup` 写外部地址的场景。）
  * 2. **基址无尾斜杠**——`market/api.ts` 按 `${base}/bundles.yaml` 拼。
  *
  * 文本版（`resolveCdnLayoutFromConfig`）与工程版（`resolveCdnLayout`）分工：前者纯函数便于单测，

package/src/market/command.ts

@@ -114,26 +114,3 @@ export async function marketCommand(sub: string, argv: string[]): Promise<void>
 			throw new Error(`[ojm] 未知子命令：ojm market ${sub}\n可用：setup / publish / build-index`);
 	}
 }
-
-/** `ojm market` 无子命令时的提示（与 usage.ts 同源风格） */
-export function marketUsage(): string {
-	return [
-		"ojm market setup   [--url <站点地址>] [--user <u> --pass <p>] [--new-pass <p>]   把市场地址指向本地 cdn/",
-		"ojm market publish [--fixture <name>@<version>] [--real <方案工程>] [--id <key>] [--rebuild-index]",
-		"ojm market build-index           [--id <key>] [--check]                        扫描 cdn/ 重建索引",
-		"ojm market verify [--file <tgz>] [--rebuild-index]                             离线验包（不起站点、不装）",
-		"ojm market trial [--fixture <name>@<version>] [--keep]                          隔离站点试装（跑完即毁）",
-		"ojm market walkthrough [--only <op>] [--strict] [--keep]                        隔离站点跑全套市场操作并出 AC 表",
-	].join("\n");
-}
-
-/** 进程入口：从 argv 取子命令（index.ts 负责 dispatch 到此处） */
-export async function runMarket(argv: string[]): Promise<void> {
-	const sub = argv[0] ?? "";
-	if (sub === "" || sub === "--help" || sub === "-h") {
-		console.log(marketUsage());
-		return;
-	}
-	await marketCommand(sub, argv.slice(1));
-	void process;
-}

package/src/market/setup.ts

@@ -1,9 +1,13 @@
 /**
  * `ojm market setup`（T5）：把 `framework.market_cdn_url` 指向本地模拟 CDN。
  *
+ * 2026-10-23 起**非必需**：脚手架 seed 的缺省值即相对路径 `/cdn`（本站点自供，
+ * dev 形态 ojm 已把 /cdn 反代给 oj 子进程），新工程免 setup。本命令只剩一个场景：
+ * 指向**外部真 CDN**（或本地但要写绝对地址）时显式改写设置。
+ *
  * 两件容易踩的事都收在这一处：
- * 1. **地址必须是绝对的**，且端口来自 config 的 `server.port`——dev 形态下 dev server（5174）
- *    只会把 `/api` 反代给 oj 子进程，`/cdn/*` 会被静态层回落成 index.html（设计 §3.1.1）。
+ * 1. **地址必须是绝对的**，且端口来自 config 的 `server.port`——写给外部访问方的地址，
+ *    相对路径对浏览器/服务端消费另有按请求源补全的口径（market/api.ts withSiteOrigin）。
  * 2. **首跑凭据悬挂**：seed admin `must_change=1`，登录拿的是限权 token，写不了 system 设置；
  *    须先 `PUT /api/auth/password` 改密换全权 token（该端点是悬挂期唯一可用写端）。
  */
@@ -56,6 +60,14 @@ export async function setupMarketUrl(opts: SetupOptions = {}): Promise<SetupResu
 	};
 }
 
+/**
+ * setup 后用于登录的口令：改密闭环走了才用 newPass，否则原口令。
+ * 当前 seed must_change=0（账号名=角色名口径）时 setup 不改密，恒用 newPass 会 401。
+ */
+export function loginPasswordAfterSetup(result: SetupResult, newPass: string, originalPass: string): string {
+	return result.changedPassword ? newPass : originalPass;
+}
+
 /** 登录并在必要时走改密闭环，返回可用 token */
 async function obtainToken(fetchFn: typeof fetch, base: string, user: string, pass: string, newPass: string | undefined, projectRoot: string): Promise<{ value: string, changedPassword: boolean, generatedPassword?: string }> {
 	let login: { access_token?: string, restricted?: boolean };

package/src/market/trial.ts

@@ -15,7 +15,7 @@ import process from "node:process";
 import { callApi, login, pollTask } from "../site";
 import { bootstrapIsolatedSite } from "./bootstrap";
 import { parseFixtureSpec } from "./fixture";
-import { setupMarketUrl } from "./setup";
+import { loginPasswordAfterSetup, setupMarketUrl } from "./setup";
 
 export interface TrialOptions {
 	/** 源工程（提供 bin/oj 与 cli 模板）；缺省 process.cwd() */
@@ -53,7 +53,7 @@ export async function trialInstall(opts: TrialOptions = {}): Promise<TrialResult
 	try {
 		// 1) 打开市场地址：隔离库是全新 seed，首登必然处于改密悬挂期 → setup 顺带完成改密
 		const newPass = "trial-pass-1";
-		await setupMarketUrl({
+		const setup = await setupMarketUrl({
 			projectRoot: site.root,
 			url: site.baseUrl,
 			user: site.admin.user,
@@ -61,7 +61,7 @@ export async function trialInstall(opts: TrialOptions = {}): Promise<TrialResult
 			newPass,
 		});
 
-		const token = await login(fetch, site.baseUrl, site.admin.user, newPass);
+		const token = await login(fetch, site.baseUrl, site.admin.user, loginPasswordAfterSetup(setup, newPass, site.admin.pass));
 
 		// 2) 首次安装：预期停在 needs_trust（发布方是本次临时生成的身份）
 		let task = await installOnce(site.baseUrl, token, spec.name, spec.version);

package/src/market/walkthrough.ts

@@ -19,6 +19,7 @@ import fs from "node:fs";
 
 import path from "node:path";
 import process from "node:process";
+import { resolveLayout } from "../layout";
 import { signCommand } from "../sign";
 import { callApi, login, pollTask, unwrapEnvelope } from "../site";
 import { bootstrapIsolatedSite, derivePublisherKey } from "./bootstrap";
@@ -27,7 +28,7 @@ import { FAILURE_PLAYBOOK } from "./failure-playbook";
 import { buildEvilZipSlipTgz, parseFixtureSpec } from "./fixture";
 import { publishPackage } from "./publish";
 import { writeWalkthroughReport } from "./report";
-import { setupMarketUrl } from "./setup";
+import { loginPasswordAfterSetup, setupMarketUrl } from "./setup";
 
 interface Ctx {
 	site: IsolatedSite
@@ -154,7 +155,7 @@ const OPS: Op[] = [
 			if (task.status !== "done")
 				return { ok: false, detail: `升级安装未 done：status=${task.status} stage=${task.stage ?? "?"}：${task.message}` };
 			const card = await indexCard(ctx);
-			const distDir = path.join(ctx.site.root, "api", "dist");
+			const distDir = resolveLayout(ctx.site.root).apiDist;
 			const dir010 = path.join(distDir, `${ctx.name}-0.1.0`);
 			const dir020 = path.join(distDir, `${ctx.name}-0.2.0`);
 			const mig010 = path.join(dir010, "migrations", "0001__init.sql");
@@ -185,7 +186,7 @@ const OPS: Op[] = [
 					return { ok: false, detail: `前置安装 0.2.0 未 done：status=${pre.status}：${pre.message}` };
 				card = await indexCard(ctx);
 			}
-			const distDir = path.join(ctx.site.root, "api", "dist");
+			const distDir = resolveLayout(ctx.site.root).apiDist;
 			const before = fs.readdirSync(distDir).sort(); // 零副作用基线：0.1.0 目录是前序合法安装的产物，不代表本次落盘
 			const task = await installOnce(ctx, "0.1.0"); // 包内最大 seq 1 < head 2
 			const blocked = task.status === "failed" && task.stage === "migrating";
@@ -340,7 +341,7 @@ const OPS: Op[] = [
 		run: async (ctx) => {
 			const evil = path.join(ctx.site.cdnDir, `${ctx.name}-evil.tgz`);
 			buildEvilZipSlipTgz(evil); // 成员含 ../evil.sql，无需发布进索引（file 源直传）
-			const distDir = path.join(ctx.site.root, "api", "dist");
+			const distDir = resolveLayout(ctx.site.root).apiDist;
 			const before = fs.readdirSync(distDir).sort(); // 零副作用基线：9.9.9 目录可能是前序 neg-stranger 的合法产物
 			try {
 				let msg = "";
@@ -373,8 +374,8 @@ export async function walkthrough(opts: WalkthroughOptions = {}): Promise<Walkth
 	const site = await bootstrapIsolatedSite({ projectRoot: opts.projectRoot, fixture: opts.fixture, keep: opts.keep, onLog: log });
 	try {
 		const newPass = "trial-pass-1";
-		await setupMarketUrl({ projectRoot: site.root, url: site.baseUrl, user: site.admin.user, pass: site.admin.pass, newPass });
-		const token = await login(fetch, site.baseUrl, site.admin.user, newPass);
+		const setup = await setupMarketUrl({ projectRoot: site.root, url: site.baseUrl, user: site.admin.user, pass: site.admin.pass, newPass });
+		const token = await login(fetch, site.baseUrl, site.admin.user, loginPasswordAfterSetup(setup, newPass, site.admin.pass));
 		const ctx: Ctx = { site, base: site.baseUrl, token, name: spec.name, version: spec.version, log };
 
 		const selected = opts.only === undefined ? OPS : OPS.filter(op => op.key === opts.only);

package/src/new.ts

@@ -124,6 +124,11 @@ title: ${name}
 summary: ${name} 方案（ojm new 生成的骨架，替换为你的描述）
 changelog:
   - 0.1.0 首个版本（ojm new 生成）
+# 市场验包五必填（market verify structureCheck）：peerRuntime 对宿主运行时强制比对（C2-09），
+# archive 为 Form A 占位（tgz 内仅允许 file 键，C2-29；发布侧由 publish 填 Form B）。
+peerRuntime: ">=0.0.0"
+archive:
+  file: ${name}-0.1.0.tgz
 ${api}web:
   route_prefix: /${name}
   entry: modules/${name}/0.1.0/entry.js
@@ -200,9 +205,22 @@ tables: []
 }
 
 function apiTs(name: string): string {
+	// 形状契约：oj 内省只读 default export、链尾须为 HTTP 动词——ping 做成嵌套组
+	// （链 ping.get → GET /api/<name>/ping）；裸命名导出不进 default 会产出空 routes.js
+	// （20261023 市场链路演练实踩）。
 	return `// GET /api/${name}/ping —— 健康探针示例（保存即热更；出参挂平级 .response 即入 openapi.json）。
-export async function ping() {
-	json.ok({ pong: true, module: "${name}" });
-}
+const ping = {
+	async get() {
+		json.ok({ pong: true, module: "${name}" });
+	},
+};
+
+ping.get.response = {
+	type: "object",
+	required: ["pong"],
+	properties: { pong: { type: "boolean" } },
+};
+
+export default { ping };
 `;
 }

package/src/preview-config.ts

@@ -3,7 +3,7 @@
  *
  * 单服务 preview 由 oj 一个进程同时出 API 与静态（web 挂载 + spa: true），
  * 而 spa 只能来自 config 文件（CLI --app-path 的 upsert 保留但不设置
- * spa——实测 oj 0.1.80）。用户在模板里手改 config 不可取（web/dist 缺失时
+ * spa——实测 oj 0.1.80）。用户在模板里手改 config 不可取（dist/web 缺失时
  * oj serve 整体拒启，会连带挂掉 ojm dev），故 preview 现场生成一份
  * 派生 config：
  *
@@ -37,7 +37,7 @@ export interface DerivePreviewConfigOptions {
 	 */
 	prefix?: string
 	/**
-	 * release 形态的后端模块根（api/dist）。给了且原 config 声明了 platform.modules 时，
+	 * release 形态的后端模块根（layout.apiDist = dist/api）。给了且原 config 声明了 platform.modules 时，
 	 * 把 `platform.root` 一并改写到该目录——特权模块的受控根必须与 `--api-path` 同源，
 	 * 否则 release 下 reloadConfig 会按 dev 的 src 判定归属（装好的方案热更不生效）。
 	 */

package/src/preview.ts

@@ -6,8 +6,9 @@
  * **单进程同时出 API 与静态**）。ojm 不再自建 http server、不再反代——
  * 前后端同端口同进程，与「oj serve + web 挂载」的生产公式逐字同形。
  *
- * 派生 config 为临时产物（api/.ojm-preview.yaml，与原件同目录保证相对
- * 路径解析一致），三路清理：ready 拒绝路径 / SIGINT / process exit 兜底
+ * 派生 config 为临时产物（module-root：工程根 .ojm-preview.yaml，与原件同目录
+ * 保证相对路径解析一致；历史布局才是 api/.ojm-preview.yaml），三路清理：ready
+ * 拒绝路径 / SIGINT / process exit 兜底
  * （语义与落盘见 preview-config.ts）。
  *
  * web.config.ts 的 htmlTransform 是 serve 期钩子，单服务下 oj 直出 HTML
@@ -59,7 +60,7 @@ export async function runPreview(projectRoot: string, opts: PreviewOptions = {})
 	const siteDir = opts.siteDir ?? layout.distDir;
 	const ojBin = resolveOjBin(projectRoot);
 	const configPath = resolveConfigPath(projectRoot);
-	// release 根恒为扁平 api/dist（module-root 只改源码布局，不改产物形状——设计 C-3/C-7）
+	// release 根恒为扁平 dist/api（module-root 只改源码布局，不改产物形状——设计 C-3/C-7）
 	const apiDist = layout.apiDist;
 
 	// fail-fast 四查：缺一即提示对应补救（init 幂等补缺 / ojm build 产物）
@@ -89,7 +90,7 @@ export async function runPreview(projectRoot: string, opts: PreviewOptions = {})
 	// 派生 config 在 migrate 成功后落盘：失败即退路径零残留
 	const base = readOjApiPrefix(configPath);
 	const writer = opts.configWriter ?? ((root: string, o: { siteDir: string, prefix?: string, port?: number, apiRoot?: string }) => writePreviewConfig(root, o));
-	// apiRoot 交给派生器：release 下 platform.root 必须指向 api/dist（与 --api-path 同源）
+	// apiRoot 交给派生器：release 下 platform.root 必须指向 dist/api（与 --api-path 同源）
 	const preview = writer(projectRoot, { siteDir, prefix: sitePrefix, port: opts.port, apiRoot: apiDist });
 
 	// / api 挂载与注入的 web 挂载配对时 oj 不开 SPA 回落（oj 语义，见 devkit 手册 §13）。

package/src/publish.ts

@@ -126,25 +126,3 @@ export function publishCommand(dir: string, opts: PublishOptions = {}): PublishR
 	}
 	return { bundlesPath, manifestsPath, bundlesSigPath, manifestsSigPath, keyId, publicKeyHex, fingerprint: fingerprintOfPublicKey(publicKeyHex), checkPassed };
 }
-
-/** `ojm publish <dir> [--id <publisher.id>] [--key <pem>] [--check]` 参数解析 */
-export function parsePublishArgs(argv: string[]): { positionals: string[], id?: string, key?: string, check?: boolean } {
-	const values: Record<string, string> = {};
-	let check = false;
-	const positionals: string[] = [];
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i]!;
-		if (a === "--check") {
-			check = true;
-			continue;
-		}
-		if (a === "--id" || a === "--key") {
-			values[a] = argv[i + 1] ?? "";
-			i++;
-			continue;
-		}
-		if (!a.startsWith("--"))
-			positionals.push(a);
-	}
-	return { positionals, id: values["--id"], key: values["--key"], check };
-}

package/src/sign.ts

@@ -104,28 +104,6 @@ export function signCommand(tgz: string, opts: SignOptions = {}): SignResult {
 	return { sigPath, keyId, publicKeyHex, fingerprint: fingerprintOfPublicKey(publicKeyHex), sha256, canonical, checkPassed };
 }
 
-/** `ojm sign <tgz> [--id <publisher.id>] [--key <pem>] [--check]` 参数解析 */
-export function parseSignArgs(argv: string[]): { positionals: string[], id?: string, key?: string, check?: boolean } {
-	const values: Record<string, string> = {};
-	let check = false;
-	const positionals: string[] = [];
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i]!;
-		if (a === "--check") {
-			check = true;
-			continue;
-		}
-		if (a === "--id" || a === "--key") {
-			values[a] = argv[i + 1] ?? "";
-			i++;
-			continue;
-		}
-		if (!a.startsWith("--"))
-			positionals.push(a);
-	}
-	return { positionals, id: values["--id"], key: values["--key"], check };
-}
-
 /** 身份从文件名推导（<name>-<version>.tgz；与 ojm install parseTarget 同规则，Finding C 正则） */
 function deriveIdentity(stem: string): { name: string, version: string } {
 	const m = /^(.+)-(\d[\w.]+(?:-[\w.]+)?)$/.exec(stem);