Skip to content

docs: add blueprint graphify and review engine planning packages#15

Merged
Li-Sanze merged 8 commits intomainfrom
merge/blueprint-graphify-docs
Apr 20, 2026
Merged

docs: add blueprint graphify and review engine planning packages#15
Li-Sanze merged 8 commits intomainfrom
merge/blueprint-graphify-docs

Conversation

@Li-Sanze
Copy link
Copy Markdown
Collaborator

@Li-Sanze Li-Sanze commented Apr 20, 2026

摘要

  • 新增 Blueprint Graphify / 可插拔 enhancer 架构方案包。
  • 新增 UX perception tuning 方案材料。
  • 新增并优化 CrossReview 方案包。
  • 归档已完成方案,并清理废弃方案包。

说明

  • 本 PR 聚焦文档和方案包,不包含运行时代码变更。
  • 已保留 main 上的 runtime gate 测试环境隔离修复。
  • 20260417_risk_engine_upgrade 暂不纳入本 PR。

Key changes:
- DEFAULT_CONFIG stable key: blueprint_enhancers: {} for unconditional validation
- Pure class registry: ClassVar name, classmethod is_available/validate
- EnhancerConfigError: fail-closed on config errors, fail-open on missing deps
- inject_auto_sections: replacement function + CRLF preservation
- history scan: plan-level granularity (not month dirs), YYYYMMDD sort convention
- Private key whitelist per enhancer (history_scan_depth with bool guard)
- Unknown enhancer + enabled:true → raise (not silent ignore)
…fact for machines

- Add design principle 6: runtime exposes stale signal, does not auto-execute enhancers
- Replace simple finalize prompt with dual-channel trigger mechanism:
  - engine.py: conditional notes.append() for human-readable hint
  - handoff.py: blueprint_enhancer_refresh structured artifact for machine consumption
- Update task 3.2 with concrete implementation details
- Add evolution roadmap (Phase 4.4 freshness gate → Phase 4+ host/CI auto-trigger)
- Add 'trigger' field (enabled_enhancer_config_present) alongside 'reason' (plan_finalized)
- reason = lifecycle event, trigger = config-level cause for recommendation
- Host dispatches on trigger field, not artifact key presence
- Extensible: Phase 4.4 uses trigger=enhancer_output_stale
@Li-Sanze Li-Sanze merged commit 4fdb42f into main Apr 20, 2026
2 of 4 checks passed
@Li-Sanze Li-Sanze deleted the merge/blueprint-graphify-docs branch April 20, 2026 05:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant