fix(create-objectstack): 远程模板的对象名改写被静默跳过 —— 5/6 已发布模板对新用户不可用 (#4926)

[os-zhuang]

Closes #4926。

npx create-objectstack@latest my-app -t todo(以及 compliance / content / contracts / procurement)产出的工程连 objectstack build 都过不去。6 个模板里 5 个如此,只有本仓库自带的 blank 是好的。夜间金丝雀 —— 那个存在意义就是当新用户探针的 workflow —— 连续 20 次定时运行全红(≥2026-07-27),因为它 if: github.event_name == 'schedule',PR 永远不跑,夜里没人看。

根因:同名文件、两套 schema

rewriteProjectIdentity 只从 objectstack.manifest.json 读模板原始 namespace。而这个文件名对应两种完全不同的文档:

	自带 blank	远程模板
schema	app 形态	$schema: …/template-manifest.json(注册表文档)
namespace	有	没有
真实 namespace	manifest + config	只在 objectstack.config.ts

于是远程模板一律读到 undefined,&& templateNamespace 守卫落空,对象名改写整段跳过;而 config 的 namespace: 是无条件改写的。结果 namespace: 'my_app' 与 name: 'todo_task' 并存,违反 ${namespace}_${shortName}。

代码注释本身留了线索 ——「Used to swap the bundled template's literal blank_ prefix」:这段逻辑从设计起就只考虑自带模板。

改动

抽出 src/rewrite-identity.ts(index.ts 在 import 时 program.parse(),里面的东西测不了 —— pkg-utils.ts 当初就是为此而拆):

1. objectstack.config.ts 成为 namespace 的权威来源,manifest 降为回退。config 里的 namespace: 正是脚手架自己要改写的那个字面量,两者不可能不一致。
2. 改写完成后自我校验。「静默什么都没做」和「本来就不需要做」在外部同形 —— 这个歧义正是本缺陷得以出厂的原因。残留任何旧前缀就抛错,指名文件与行号,把失败拉回脚手架现场,而不是留给用户的第一条 objectstack build。

验证

用 objectstack-ai/templates@960f24d 的真实模板对新旧逻辑各跑一遍:

模板	旧逻辑 namespace	新逻辑	应改写	旧逻辑实改	新逻辑残留
todo	undefined	todo	7	0	0
compliance	undefined	compliance	17	0	0
content	undefined	content	22	0	0
contracts	undefined	contracts	12	0	0
procurement	undefined	procurement	16	0	0

生产上共 74 处对象名从未被改写。

其余闸门:

• 10 个新单测,覆盖两种 manifest 形态、回退路径、两者皆无、以及 manifest 不可解析;
• 自带 blank 无回归:实跑脚手架产出 namespace: 'regr_app' + name: 'regr_app_note';
• 包内测试 28/28,tsc --noEmit 与 eslint 均为 0 退出码。

未在本 PR 处理

金丝雀「只在夜里跑且无人看」这个结构性问题本身没修 —— 本 PR 只让它接下来会变绿。要不要给它加通知/让 PR 也跑,由维护者定。

🤖 Generated with Claude Code

https://claude.ai/code/session_01BbNVKv6KgPzuQ5p76nMgnf

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 3, 2026 4:32pm

[github-actions]

📓 Docs Drift Check

This PR changes 1 package(s): create-objectstack.

8 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

• content/docs/ai/skills-reference.mdx (via create-objectstack)
• content/docs/ai/skills.mdx (via create-objectstack)
• content/docs/deployment/self-hosting.mdx (via create-objectstack)
• content/docs/getting-started/index.mdx (via create-objectstack)
• content/docs/getting-started/your-first-project.mdx (via create-objectstack)
• content/docs/plugins/packages.mdx (via create-objectstack)
• content/docs/releases/v15.mdx (via create-objectstack)
• content/docs/releases/v9.mdx (via create-objectstack)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.