docs: development assessment for app-metadata reference-integrity lint (#3583) - #3640
Merged
os-zhuang merged 2 commits intoJul 27, 2026
Merged
Conversation
#3583) Maps the nine HotCRM bug categories from #3583 against the current validation surface (defineStack cross-refs, @objectstack/lint rules, CLI wiring), identifies the two structural root causes (no shared resolution substrate / prefix-heuristic platform-object guessing; validate-lint wiring drift), and routes the work: 4 immediate hole-fixes, a shared PLATFORM_PROVIDED_OBJECT_NAMES registry + ResolutionContext substrate, 7 phased lint rules behind the ADR-0078 verify-then-enforce ratchet, and 5 open decisions (knowledge-index definition site, runtime-registered skills, nav-access placement, hook-body writes, rule-suite wiring). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GBks5G7AkwrvgF2kL5rfkT
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
github-actions
Bot
added
documentation
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GBks5G7AkwrvgF2kL5rfkT
github-actions
Bot
added
documentation
os-zhuang
marked this pull request as ready for review
July 27, 2026 12:29
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
针对 #3583 的开发方案评估文档(development assessment,仅路由工作、不做架构决策,沿用
2026-06-ask-build-agent-development-assessment.md的先例格式)。核心结论:HotCRM 审计出的 ~20 处已发布实例可收敛为 7 条 lint 规则 + 4 个小洞修复 + 1 个共享解析基座,按 ADR-0078 的 verify-then-enforce 棘轮分期落地。
逐类盘点(§1):9 类问题各自映射到 spec 授权面、现有检查与缺口(file:line 级证据)。其中 2 类不能直接写规则:knowledge indexes 在 stack 里根本没有定义位(需先做 spec 决策 D1);hook body 写入是不透明 JS 源码,静态检查诚实地说做不到(D4)。
两个结构性根因(§2):
sys_|cloud_|ai_前缀启发式是假阴性来源(sys_approval_process全线放行)。validate/lint/compile/doctor各自接线不同的规则子集。分期方案(§3):Phase 0 立即可落的 4 个小修(areas 导航未校验、i18n 数组 options bug、chart dataset 缺失旁路、hook 数组 object);Phase 1 共享基座(spec 导出
PLATFORM_PROVIDED_OBJECT_NAMES注册表 + lint 侧ResolutionContext,用属主包 conformance test 保持注册表诚实、不破坏 lint→spec 单向依赖);Phase 2/3 按规则逐条 PR。§4 给出统一的严重级阶梯(未前缀未解析→error;前缀但不在注册表→warning + 显式 opt-out)。§5 列出 5 个待决策项;§6 以 HotCRM 实例为回归语料。关联:#3583 · ADR-0072 / ADR-0078 / ADR-0049
Generated by Claude Code