soloforge 1.1.46 → 1.1.48

package/templates/shared//346/225/260/346/215/256/346/235/203/351/231/220.md

@@ -1,47 +0,0 @@
----
-id: ka-domain_knowledge-data-permission
-kind: knowledge
-title: 数据权限
-sync_policy: copy_to_project
-status: active
-extra:
-  name: data-permission
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-domain-knowledge
----
-
-## 业务规则
-1. 用户只能查看其权限范围内的数据（按部门、区域、业务线等维度隔离）
-2. 数据权限在功能权限之上叠加，即使用户有功能权限，也受数据范围约束
-3. 数据权限变更实时生效（非缓存延迟）
-4. 管理员可查看全部数据，但仍需审计记录
-5. 数据权限必须支持多维度控制：组织架构（部门/区域）、数据范围（本人/本部门/本部门及下级/全部）
-6. 数据权限过滤必须在 Repository/Mapper 层实现，禁止在 Service 层硬编码过滤条件
-7. 数据权限变更必须实时生效，不能要求用户重新登录
-
-## 约束条件
-- 数据权限规则存储在数据权限表中（user_id → scope_type + scope_value）
-- MyBatis 拦截器根据当前用户自动注入数据范围过滤条件
-- 新建业务表需考虑数据权限字段（如 dept_id、region_id）
-- 数据权限查询性能需优化（大批量数据过滤使用 JOIN 而非 IN）
-- 数据权限必须与角色解耦，一个角色可配置不同的数据范围
-- 管理员（超管）可以查看全部数据，但仍需记录访问日志
-
-## 例外情况
-- 系统级数据（字典、配置）不受数据权限约束
-- 跨部门协作场景需额外的数据共享授权机制
-- 公共数据（如数据字典、系统配置）不受数据权限控制
-
-## 关联模式
-参见 auth-permission 模式（功能权限模型）、multi-tenancy 模式（租户级数据隔离）
-- auth-permission
-- naming-convention

package/templates/shared//346/226/275/345/267/245/346/214/207/344/273/244/345/245/221/347/272/246.md

@@ -1,69 +0,0 @@
----
-id: ka-hard-rule-施工指令契约规则
-kind: guidance
-title: 施工指令契约
-owner_mechanism: mc-instruction-contract
-sync_policy: copy_to_project
-status: active
-extra:
-  name: construction-directive-contract
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
-triggers:
-  - 施工指令
-  - 写文件
-  - 编码
-  - 代码修改
-  - 文件创建
-  - 重构操作
-  - 验收标准
----
-
-# 施工指令契约规则
-
-## 硬规则
-
-### HR-1: 任何实现/编码/写文件前必须有施工指令
-
-AI 在执行任何代码修改、文件创建、重构操作前，必须先确认存在施工指令。
-
-施工指令必须包含以下字段（全部必填，不可为空）：
-
-| 字段 | 说明 | 示例 |
-|------|------|------|
-| 目标 | 本次施工要达成什么 | "为用户登录功能添加 JWT 认证" |
-| 范围 | 涉及哪些文件/模块 | `["src/auth/jwt.ts", "src/middleware/auth.ts"]` |
-| 非目标 | 明确不做什么 | "不改动现有 session 机制" |
-| 落点 | 产出物放在哪里 | "src/auth/jwt.ts" |
-| 验收标准 | 怎样算完成 | "单元测试通过，token 过期能正确拒绝" |
-| 禁止绕过项 | 不可跳过的检查 | "不可跳过测试、不可跳过 review" |
-
-### HR-2: 缺失字段时必须先澄清
-
-如果施工指令缺少任何必填字段，AI 必须：
-1. 向用户指出缺失的字段
-2. 提供推荐值和理由
-3. 等待用户确认后再继续
-
-**禁止**：猜测缺失字段、使用空值或占位符填充、跳过澄清直接编码。
-
-### HR-3: 施工指令不可假通过
-
-以下情况不得判定为通过：
-- 空目标/空范围/空验收标准
-- 非目标写"无"但不提供理由
-- 落点不明确（如"某个目录"）
-- 禁止绕过项列表为空
-
-### HR-4: 用户项目同样适用
-
-通过 sync-templates 注入到用户项目后，本规则在用户项目开发中同样生效。
-用户使用 SoloForge 时，AI 工具在执行写操作前会自动检查施工指令。

package/templates/shared//346/227/245/345/277/227/346/262/273/347/220/206.md

@@ -1,31 +0,0 @@
----
-id: ka-hard-rule-日志治理规则
-kind: guidance
-title: 日志治理
-owner_mechanism: mc-log-governance
-sync_policy: internal
-status: active
-extra:
-  name: log-governance
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
----
-
-# 日志治理规则
-
-SoloForge 自身输出必须通过统一日志模块，用户可见输出不得混入内部治理噪音。
-
-## 硬规则
-
-- CLI 和 MCP 用户可见输出必须中文语义优先。
-- `--json` 模式 stdout 必须是纯 JSON。
-- 引擎内部 trace 默认不得输出。
-- 直接 `console` 输出只能存在于日志封装层。

package/templates/shared//346/234/272/345/210/266/350/207/252/346/262/273/347/220/206.md

@@ -1,31 +0,0 @@
----
-id: ka-hard-rule-机制自治理规则
-kind: guidance
-title: 机制自治理
-owner_mechanism: mc-mechanism-health
-sync_policy: internal
-status: active
-extra:
-  name: mechanism-self-governance
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
----
-
-# 机制自治理规则
-
-所有新增机制必须有真实生产消费路径，不能只停留在注册表、测试或文档。
-
-## 硬规则
-
-- 引擎模块导出的核心函数必须被 CLI、MCP handler 或 release gate 消费。
-- `lazy*` 声明必须在 handler 或治理入口中实际调用。
-- `mechanism_id` 必须在双层注册、机制合同和资产清单中保持一致。
-- 行为测试必须包含 must-fail 和 must-pass，不得只验证文件存在。

package/templates/shared//346/240/207/345/207/206/350/265/204/344/272/247/350/246/206/347/233/226.md

@@ -1,50 +0,0 @@
----
-id: ka-hard-rule-标准资产覆盖规则
-kind: guidance
-title: 标准资产覆盖
-owner_mechanism: mc-standard-asset-coverage
-sync_policy: internal
-status: active
-extra:
-  name: standard-asset-override
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
----
-
-# 标准资产覆盖规则
-
-## 覆盖范围
-
-所有 `templates/**` 下的资产类型必须被审计覆盖：
-
-- 验收模版 (acceptance_templates)
-- 规则 (rules)
-- 流程 (procedures)
-- 检查清单 (checklists)
-- 审查规则 (review_rules)
-- 模式 (patterns)
-- 脚手架 (scaffolds)
-- Adapter 工作流 (adapter_workflow)
-
-## 覆盖检查要求
-
-每个资产必须具备：
-
-1. **标准承载路径** — 资产存放在正确的类型目录中
-2. **复验路径** — 可通过 sf_gate、template_mechanism_auditor 或 validate-release 复验
-3. **主链路消费者** — 被实际工具（sf_work action=act、sf_gate、sf_work action=verify 等）消费
-
-## 门禁规则
-
-- P0 资产缺少标准承载路径时 hard_fail
-- P0 资产未在 Consumable Asset Registry 注册时 hard_fail
-- P0 资产缺少 owner_mechanism_id 时 hard_fail
-- `mc-design-artifact-pack` 仅作为首批 P0 子机制保留

package/templates/shared//346/240/270/345/277/203/344/275/223/351/252/214/345/216/237/345/210/231.md

@@ -1,38 +0,0 @@
----
-id: ka-hard-rule-core-experience-principle
-kind: guidance
-title: 核心体验原则
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 新增机制
-  - 新增模版
-  - 新增 workflow
-  - 发布门禁
-extra:
-  name: core-experience-principle
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-core-experience-principle
----
-
-## 核心体验原则
-
-### 四条原则
-1. **机制强，路径短** — 机制必须接入真实主链路，用户主入口不超过一次自然语言指令或一个 CLI 命令
-2. **规则硬，体验轻** — 关键失败硬阻断，低风险任务轻量
-3. **证据足，不啰嗦** — 证据可审查，输出清晰简洁
-4. **能自动修复，不假装完成** — 失败进入 repair_reverify 或 manual_required
-
-### 禁止
-- 机制只存在于文档，不接主链路
-- 硬规则降级为 warning 后继续
-- 验证失败后标记 completed/delivered

package/templates/shared//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214/345/216/237/345/210/231.md

@@ -1,154 +0,0 @@
----
-id: ka-hard-rule-核心工程执行原则
-kind: guidance
-title: 核心工程执行原则
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 实现
-  - 编码
-  - 开发
-  - 重构
-  - 写代码
-  - 改bug
-  - 修复
-extra:
-  name: core-engineering-principles
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-core-engineering-principles
----
-
-# 核心工程执行原则
-
-> 适用: 所有 code_execution / multi_stage_plan / single_artifact 路由。
-
-## 四条原则
-
-### 原则一: Think Before Coding — 编码前先思考
-
-编码前先明确问题、目标、输入、约束和不确定性。不假设、不隐藏困惑、不把模糊需求直接转成代码。
-
-**必须做到:**
-- 暴露阻塞性困惑，不假装理解
-- 区分可推断事实、假设、需要用户确认的问题
-- 只问最小阻塞问题，不把非阻塞细节抛给用户
-- 把 material 级不确定记录为 assumption，不得假装确定
-
-**硬失败条件:**
-- 缺少必要输入却开始写代码
-- 写入 scope 不明确却修改文件
-- 外部副作用权限不明确却执行命令
-- 把未知事实写成确定结论
-- 隐藏需要用户确认的业务口径
-
-**不确定性分级:**
-- `blocking`: 不问不能继续（写入路径、业务口径、外部副作用授权、破坏性操作）
-- `material`: 可先推进，但必须记录假设和风险（UI 文案偏好、非关键默认配置）
-- `minor`: 可合理默认，但在结果里说明（文件命名细节、无风险排序偏好）
-- `non_blocking`: 不打断用户，不影响当前执行
-
-### 原则二: Simplicity First — 简单优先
-
-优先用最少代码、最少抽象、最少新增文件解决已确认目标。不为了未确认的未来需求提前设计复杂结构。
-
-**必须做到:**
-- 最少代码解决问题
-- 引入新抽象、新依赖、新模块时说明必要性
-- 不为简单 CRUD 强行套复杂领域模型
-
-**硬失败条件:**
-- 为局部问题引入无必要新依赖
-- 为简单修复新增大范围架构层
-- 没有用户目标支撑却扩展公共 API/配置/registry
-- 使用复杂方案绕过已有简单本地模式
-
-**不是"少做":**
-- 不写测试不叫简单
-- 不接主链路不叫简单
-- 不处理边界不叫简单
-- 不做必要错误处理不叫简单
-- 不建必要抽象不叫简单
-
-**minimum_sufficient_solution 必须满足:**
-- 满足用户目标
-- 接入真实路径
-- 覆盖关键失败路径
-- 有验证证据
-- 没有不必要抽象/依赖/公共 API 扩张
-
-### 原则三: Surgical Changes — 精准修改
-
-只改必须改的内容，不顺便重构、不无关格式化、不扩大 scope、不污染用户已有改动。
-
-**必须做到:**
-- 只改必要文件、必要行、必要行为
-- 遇到用户已有修改时必须保护，不得回滚
-
-**硬失败条件:**
-- 修改 scope 外文件
-- 修改与目标无关的文件或行为
-- 未经确认回滚用户已有改动
-- 大范围格式化掩盖真实变更
-- 为了让测试过而删除断言、降低覆盖率、增加无关 mock
-
-**允许的必要联动修改:**
-- 主链路接入必须修改入口文件
-- 类型变化必须修改调用方
-- schema 变化必须修改 model/query/API
-- 验证失败需要修改测试或 fixture
-- contract 状态变化必须修改 registry、diagnostic、verification 和相关测试
-
-### 原则四: Goal-Driven Execution — 目标驱动执行
-
-先定义可验证目标，再执行；执行后必须验证；验证失败要修复并重新验证，直到通过或明确阻塞。
-
-**必须做到:**
-- 明确目标和验收标准
-- 禁止"功能正常""看起来没问题"等模糊成功标准；必须写出已执行验证和剩余风险
-- 输出未验证项和人工确认项
-
-**硬失败条件:**
-- 没有可验证目标就开始实现
-- 没有 VerificationPlan 就标记完成
-- 未执行验证却输出"全部通过"
-- 验证失败仍进入 completed / delivery_ready
-- 隐藏未验证项
-
-## 原则冲突优先级
-
-```text
-安全/权限/隐私 > Goal-Driven Execution > Think Before Coding > Surgical Changes > Simplicity First
-```
-
-裁决规则:
-- 不能为了简单而牺牲验证
-- 不能为了少改而不接入主链路
-- 不能为了快而隐藏阻塞性不确定性
-- 必要验证、必要入口接入、必要错误处理优先于"少写代码"
-
-## 反规避规则
-
-四原则必须由证据证明，不接受 AI 自述。
-
-伪满足示例:
-- 写一句"已思考清楚"，但没有输入、假设、目标证据
-- 说"保持简单"，但实际新增大抽象
-- 说"只改必要文件"，但 diff 里有无关变更
-- 说"验证通过"，但没有真实 evidence
-- 把未执行验证写成"建议验证"后仍标记完成
-- 把用户没确认的业务口径写成事实
-
-硬规则:
-- 自述不能代替 ClarificationNeed / AssumptionRecord / GoalDefinition / VerificationEvidence
-- required 原则失败不能进入 completed
-- 验证失败必须进入 repair_reverify 或 manual_required
-- 不能用 advisory 结果覆盖 required 失败

package/templates/shared//346/250/241/347/211/210Frontmatter.md

@@ -1,125 +0,0 @@
----
-id: 模版Frontmatter
-kind: guidance
-title: 模版 Frontmatter 规范
-sync_policy: internal
-status: active
-triggers:
-  - 模版文件写入、frontmatter 校验、资产注册
-owner_mechanism: mc-standard-asset-contract
----
-
-# 模版 Frontmatter 规范（归零重构版）
-
-> 权威来源：本文档定义 `templates/` 下所有 .md 资产的 frontmatter 字段合法值、必填/选填、语义。
-> 目录按研发阶段组织（design/build/verify/operate/shared），不再按资产类型分目录。
-
----
-
-## 一、字段体系
-
-### 1.1 核心字段（所有 kind 共有，必填）
-
-| 字段 | 必填 | 合法值 | 说明 |
-|------|:---:|--------|------|
-| `id` | ✅ | 唯一标识 | 资产 ID |
-| `kind` | ✅ | `artifact` / `guidance` / `enforced` / `knowledge` | 资产种类 |
-| `sync_policy` | ✅ | `engine_only` / `copy_to_project` / `internal` | 同步策略 |
-| `status` | ✅ | `active` / `retired` | 生命周期状态 |
-
-### 1.2 kind 语义
-
-| kind | 含义 | 目录 | 额外字段 |
-|------|------|------|----------|
-| `artifact` | 产出模板（AI 按此格式写产出） | design/build/verify/operate | `title` |
-| `guidance` | 工程经验/审查指导（注入 AI prompt） | 各 stage + shared | `title` + `triggers` |
-| `enforced` | 强制检查清单（gate bridge 聚合执行） | 各 stage（`enforced.md`） | `gate` + `checks` |
-| `knowledge` | 知识条目（决策规则/模式） | 主要 shared | `title` |
-
-### 1.3 各 kind 额外字段
-
-**guidance 必填 `triggers`**（非空数组，否则永不注入=死文件）：
-```yaml
-triggers: [并发, 线程, 锁]
-```
-
-**enforced 必填 `gate` + `checks`**：
-```yaml
-gate: build-gate
-checks:
-  - id: TS-Q01
-    executor: regex_pattern_scan
-    rule: 禁止 as any
-    severity: error
-    check_type: deterministic
-    evidence_required: [...]
-    gate: build-gate
-    target: self
-```
-
-**gate 合法值**：`design-gate` / `build-gate` / `verify-gate` / `operate-gate` / `slice-gate` / `shared-gate`
-
-**check.executor 合法值**（须在 gate_executors 注册）：
-`regex_pattern_scan` / `document_structure` / `file_evidence` / `external_command` / `tsc_compile` / `vitest_run` / `file_scope_check` / `test_count_check` / `lazy_pattern_check` / `cross_validation` / `upstream_gate_check` / `probe` / `semantic`（客户端 AI 评判，引擎不执行）
-
----
-
-## 二、目录结构（归零重构后按阶段）
-
-```
-templates/
-  design/     需求→架构
-  build/      代码实现
-  verify/     测试审查
-  operate/    部署运维
-  shared/     跨阶段通用（knowledge/guidance + enforced.md + 切片聚合检查）
-  scaffolds/  代码脚手架（.hbs，无 frontmatter）
-  profiles/   产品配置（.yaml，无 frontmatter）
-```
-
-每个 stage 目录（design/build/verify/operate）含三种文件：
-- `<主题>.md`（artifact）— 产出模板
-- `<审查主题>.md`（guidance）— 工程经验（带 triggers）+ 审查 pattern 正文（`## CHECK-ID:` section，regex_pattern_scan 读取）
-- `enforced.md`（enforced）— 该阶段强制检查清单（gate bridge 聚合）
-
----
-
-## 三、check 聚合机制
-
-gate 不再是独立 YAML 配置文件，而是由 `gate_registry_bridge` 从 enforced 资产的 `checks` 按 `check.gate` 聚合：
-- 每个 check 自带 `gate` 字段声明归属
-- bridge 按 `check.gate` 分组（非按 asset.stage，支持规则跨 stage 引用）
-- regex_pattern_scan 执行器按 check.id 自动定位含 pattern 正文的规则文件（`## CHECK-ID:` section）
-
----
-
-## 四、旧字段进 extra（不在顶层）
-
-归零重构前的旧字段（type/stage/domain/lifecycle_status/name/scope/authority/priority/owner_mechanism_id 等）保留在 `extra` 子对象，不在顶层：
-
-```yaml
-extra:
-  name: architecture-rules
-  type: constraint
-  scope: ['*']
-  lifecycle_status: active
-  stage: design
-```
-
-**禁止**：`type`/`stage`/`domain`/`lifecycle_status`/`name` 出现在 frontmatter 顶层（护栏强制）。
-
----
-
-## 五、合规检查（tests/architecture/zero_refactor_guardrails.test.ts）
-
-| # | 规则 | 说明 |
-|---|------|------|
-| 1 | 所有 .md 必须有合法 `kind` | artifact/guidance/enforced/knowledge |
-| 2 | guidance 必须有 `triggers` 或 `owner_mechanism` | 否则死文件（待治理=0） |
-| 3 | enforced 必须有 `gate` + 非空 `checks` | checks>=1 |
-| 4 | 顶层禁止旧字段 | type/stage/domain/lifecycle_status/name 进 extra |
-| 5 | sync_policy 3 合法值 | engine_only/copy_to_project/internal |
-| 6 | status 仅 active/retired | |
-| 7 | gate 合法值 | design/build/verify/operate/slice/shared-gate |
-| 8 | check.id 在 gate 内唯一 | |
-| 9 | 每个 stage 有 enforced.md | design/build/verify/operate/shared |