specdo 1.0.2

package/dist/domains/types.d.ts

@@ -0,0 +1,354 @@
+/**
+ * Domain Module Types
+ *
+ * 每个领域模块封装一组专业领域知识，在 specdo 工作流的各阶段自动注入：
+ *   explore → 领域触发信号 + 需求澄清问题
+ *   propose → 设计检查清单 + 模式推荐 + 反模式警示
+ *   apply   → 实施关注点 + 实施模式 + 常见错误
+ *   sync    → 领域审查清单
+ *   archive → 发布前验证清单
+ */
+export interface DomainModule {
+    /** 领域名称（唯一标识符） */
+    name: string;
+    /** 领域描述（用于 domains list 命令） */
+    description: string;
+    explore?: ExploreStage;
+    design?: DesignStage;
+    implement?: ImplementStage;
+    verify?: VerifyStage;
+}
+export interface ExploreStage {
+    /** 触发该领域的关键词。多词信号匹配原文子串；短缩写精确匹配 token；普通信号做有限词形/前缀匹配。 */
+    signals: string[];
+    /**
+     * 需求澄清阶段应引导用户回答的问题。
+     *
+     * 支持两种格式:
+     *   - string[]: 传统静态问题列表（向后兼容，自动升级为合成池）
+     *   - QuestionPool: 带信号/优先级/依赖链/条件激活的问题池
+     */
+    questions: string[] | QuestionPool;
+}
+/** 问题池中的单条候选问题，带排序元数据 */
+export interface QuestionPoolItem {
+    /** 问题文本 */
+    text: string;
+    /**
+     * 可选的符号标识符（如 "auth-method", "mfa-needed"）。
+     * 用于 requiresAnswer/conditional 的稳定引用，不受 prepend/append 影响。
+     * 不设置时，回退为池中的位置索引。
+     */
+    id?: string;
+    /** 使该问题与用户输入相关的关键词 */
+    signals: string[];
+    /**
+     * 优先级权重 (1-10，默认 5)。
+     * 值越高越容易被选中。通用基础问题用 8-10，细分场景问题用 4-7。
+     */
+    priority: number;
+    /**
+     * 依赖链：仅当用户已回答引用的问题时才激活此问题。
+     * 每项格式为 "<domain>:<id>" 或 "<domain>:<poolIndex>"（回退格式）。
+     * 空数组表示无条件依赖。
+     */
+    requiresAnswer?: string[];
+    /**
+     * 条件激活：仅当已收集的回答中包含指定子串（大小写不敏感）时才激活。
+     * 例：{ "security:auth-method": "oauth" } 表示仅当 auth-method 回答中提到 OAuth。
+     * key 格式为 "<domain>:<id>" 或 "<domain>:<poolIndex>"（回退格式）。
+     */
+    conditional?: Record<string, string>;
+}
+/** 问题池容器 */
+export interface QuestionPool {
+    /** 候选问题列表（每领域 20-40 条） */
+    items: QuestionPoolItem[];
+    /** 默认选取的 top-N 数量（一般 5-8） */
+    defaultCount: number;
+}
+/** rankQuestions() 的输出项 */
+export interface RankedQuestion {
+    /** 问题文本 */
+    text: string;
+    /** 相关性分数 (0-1) */
+    score: number;
+    /** 来源：pool | llm | legacy */
+    source: 'pool' | 'llm' | 'legacy';
+    /** 原始池索引（回退 key，用于 legacy 或无 id 的条目） */
+    index: number;
+    /** 符号标识符（优先级高于 index，用于 requiresAnswer/conditional 稳定引用） */
+    id?: string;
+    /** 推荐的 answer key：id ?? `${index}` */
+    answerKey: string;
+}
+/** rankQuestions() 的输入选项 */
+export interface RankQuestionsOptions {
+    /** 用户输入的 idea 文本，用于信号匹配 */
+    input: string;
+    /** 已收集的回答，key 格式 "<domain>:<index>" */
+    existingAnswers?: Record<string, string>;
+    /** 返回的 top-N 数量（默认取池的 defaultCount 或 8） */
+    count?: number;
+}
+/** LLM 问题生成的请求 payload */
+export interface LLMQuestionRequest {
+    /** 用户的原始 idea */
+    idea: string;
+    /** 已匹配的领域及其信号分类 */
+    domains: Array<{
+        name: string;
+        signals: string[];
+        description: string;
+    }>;
+    /** 已收集的回答（用于生成追问） */
+    existingAnswers?: Record<string, string>;
+}
+/** LLM 问题生成的响应格式 */
+export interface LLMQuestionResponse {
+    /** 领域名 → 生成的问题数组 */
+    questions: Record<string, string[]>;
+}
+export interface DesignStage {
+    /** 设计阶段必须核对的检查项 */
+    checklist: string[];
+    /** 推荐的设计模式（模式名 → 何时使用 + 简要描述） */
+    patterns?: Record<string, string>;
+    /** 应避免的设计反模式（反模式 → 原因 + 替代方案） */
+    antiPatterns?: string[];
+}
+export interface ImplementStage {
+    /** 实施阶段的关键关注点 */
+    focusAreas: string[];
+    /** 推荐的实施模式（模式名 → 实现方式） */
+    patterns?: Record<string, string>;
+    /** 常见实现错误 */
+    antiPatterns?: string[];
+}
+export interface VerifyStage {
+    /** 验证阶段检查清单 */
+    checklist: string[];
+}
+/** 项目级领域规则覆盖 */
+export interface DomainOverrides {
+    explore?: StageOverrides;
+    design?: StageOverrides;
+    implement?: StageOverrides;
+    verify?: StageOverrides;
+}
+export interface StageOverrides {
+    /** false = 完全跳过此阶段 */
+    enabled?: boolean;
+    /** 仅 explore 阶段 */
+    questions?: OverrideItem[];
+    /** 通用检查项列表 */
+    checklist?: OverrideItem[];
+    /** 仅 implement 阶段 */
+    focusAreas?: OverrideItem[];
+    /** 合并到默认 patterns（同名 key 覆盖值） */
+    patterns?: Record<string, string>;
+    /** 通用反模式列表 */
+    antiPatterns?: OverrideItem[];
+}
+/**
+ * 单条列表覆盖必须且只能选择一个 action:
+ *   - prepend: 插入到默认列表前面
+ *   - append: 追加到默认列表后面
+ *   - replace: 整段替换默认列表；一旦存在 replace，prepend / append 不再参与结果
+ */
+export type OverrideItem = {
+    prepend: string;
+    append?: never;
+    replace?: never;
+} | {
+    append: string;
+    prepend?: never;
+    replace?: never;
+} | {
+    replace: string;
+    prepend?: never;
+    append?: never;
+};
+export interface DomainMatch {
+    name: string;
+    score: number;
+    /** 人类可读的匹配原因（例："Matched 3 signals: auth, oauth, token" 或 "Fallback: no signals matched"） */
+    reason: string;
+}
+/**
+ * Protocol 是流程纪律 / 闭环工作流的结构化封装，独立于 DomainModule。
+ *
+ * 设计动机:
+ *   review-to-solid 等方法论型 skill 含有 DomainModule 无法表达的语义:
+ *     1. 顺序工作流 + 循环回退（步骤 5/6 → 步骤 3 重审）
+ *     2. P1/P2/P3 严重度分级
+ *     3. 强制输出契约（Final Verdict / Findings / Fix Summary / Delta Table）
+ *     4. 工件类型分派（product / arch / README / PR / OpenSpec 各有附加检查）
+ *     5. 停止条件与禁止行为
+ *
+ *   Domain 是"应该关注什么"，Protocol 是"必须如何执行"。强行扁平化会丢失顺序和契约。
+ *
+ * 使用边界:
+ *   - Protocol 不参与 scoreDomains 的领域排序，不注册进 ALL_DOMAINS
+ *   - 由命令层（如 `apply`）按明确的架构边界注入到 brief / 提示词中
+ *   - applyOverrides 不作用于 Protocol；项目级覆盖通过专用 ProtocolOverrides 完成（未来 Phase 引入）
+ */
+export interface Protocol {
+    /** 协议名称（唯一标识符，例如 "review-to-solid"） */
+    name: string;
+    /** 协议简介，用于 protocols list 命令展示 */
+    description: string;
+    /** 协议核心目标，作为 brief 注入的开篇说明 */
+    goal: string;
+    /** 显式触发短语，命令层用于关键词识别（不参与 scoreDomains） */
+    triggerPhrases: string[];
+    /** 显式触发后的负向抑制短语，避免 copy-edit / review-only 等场景误触发重型协议 */
+    suppressionPhrases?: string[];
+    /** 不该使用本协议的负面场景，避免被误触发 */
+    doNotUseWhen: string[];
+    /** 顺序工作流步骤；步骤间允许循环回退（由 stopConditions 决定何时收敛） */
+    workflow: WorkflowStep[];
+    /** 严重度分级（例：P1/P2/P3 → 描述）；为空表示该协议无显式严重度系统 */
+    severityLevels?: Record<string, string>;
+    /** 强制输出契约；缺失任何 required 段视为协议未完成 */
+    outputContract: OutputSection[];
+    /** 停止条件：满足任一即可收敛；否则必须继续迭代 */
+    stopConditions: string[];
+    /** 禁止行为；命令层将这些注入为 "DO NOT" 列表 */
+    prohibitions: string[];
+    /**
+     * 工件类型专属检查清单（key = 工件类型；例如 "product-plan" / "architecture" /
+     * "readme" / "pr" / "prompt-agent-skill" / "openspec"）
+     *
+     * 命令层根据当前任务/工件类型选取对应清单注入；未匹配时不注入。
+     */
+    artifactChecklists?: Record<string, string[]>;
+    /** 通用约束（与具体工件类型无关） */
+    generalConstraints?: string[];
+}
+export interface WorkflowStep {
+    /** 步骤序号（1-based）；同一协议内必须唯一且连续 */
+    step: number;
+    /** 步骤标题，brief 注入时作为小节标题 */
+    title: string;
+    /** 步骤目标：为什么这一步存在 */
+    goal: string;
+    /** 步骤内的具体动作；命令层渲染为有序列表 */
+    actions: string[];
+    /** 进入下一步的退出标准；为空表示无显式门槛 */
+    exitCriteria?: string[];
+    /**
+     * 允许从该步骤回跳到的更早步骤序号（实现循环纪律）。
+     * 例：review-to-solid 的步骤 6 "Re-review" 可回到 4 "Fix" 形成 4 → 5 → 6 → 4 循环。
+     */
+    loopBackTo?: number[];
+}
+export interface OutputSection {
+    /** 段落名称（例："Final Verdict" / "Initial-vs-Final Delta Table"） */
+    name: string;
+    /** 是否必填；false 表示仅在适用条件下出现 */
+    required: boolean;
+    /** 输出格式说明（例："plain text" / "markdown table with columns: Area | Initial Issue | ..."） */
+    format: string;
+    /** 内容指引：这段必须包含什么 */
+    description: string;
+}
+export interface ChangeContext {
+    /** schema 版本，固定为 2；reader 在不匹配时必须报错或降级提示 */
+    version: 2;
+    /** 变更基本元数据 */
+    change: {
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+    };
+    explore?: ExploreStageState;
+    propose?: ProposeStageState;
+    apply?: ApplyStageState;
+    sync?: SyncStageState;
+    archive?: ArchiveStageState;
+}
+export interface ExploreStageState {
+    /** 用户输入的 idea / 描述（可能为空字符串） */
+    input: string;
+    /** scoreDomains 命中的领域（按 score 降序）；或 agent 通过 --domains 显式指定的领域 */
+    matchedDomains: DomainMatch[];
+    /** 用户对 explore.questions 的回答；key 为 "<domain>:<questionIndex>" */
+    answers: Record<string, string>;
+    /** 用户主动标记的关注点 / 风险线索 */
+    flaggedConcerns: string[];
+    /** 阶段完成时间；进行中 = null，未运行 = explore key 缺失 */
+    completedAt: string | null;
+    /** agent 收集的自由文本上下文（来自 --context flag） */
+    collectedContext?: string;
+    /** explore 深度自评：shallow | standard | deep；未设置时 propose 不发出警告（向后兼容） */
+    depth?: 'shallow' | 'standard' | 'deep' | null;
+    /** LLM 生成的问题缓存（领域名 → 问题数组），避免重复生成 */
+    llmQuestions?: Record<string, string[]>;
+}
+export interface ProposeStageState {
+    /** 各 artifact 的相对路径（相对 specdo/changes/<name>/） */
+    artifacts: {
+        proposal: string;
+        specs: string[];
+        design: string;
+        tasks: string;
+    };
+    /** propose 阶段实际注入的领域名称列表 */
+    domainsUsed: string[];
+    /** capability 语义索引，供 sync/show/archive/validate 复用 */
+    capabilities: Array<{
+        name: string;
+        kind: 'new' | 'modified';
+        specPath: string;
+    }>;
+    completedAt: string | null;
+}
+export interface ApplyStageState {
+    completedAt: string | null;
+    tasksTotal: number;
+    tasksCompleted: number;
+    /**
+     * 任务证据；key 为任务编号字符串（"1", "1.1" ...），value 为 evidence 文本。
+     * --done 时写入；--undo 时显式删除对应 key。
+     */
+    tasksEvidence: Record<string, string>;
+    /** apply-brief.md 是否已渲染 */
+    applyBriefGenerated: boolean;
+}
+export interface SyncStageState {
+    /** 已同步的 spec 相对路径列表 */
+    syncedSpecs: string[];
+    /** 未解冲突路径；非空时 archive 必须失败 */
+    conflicts: string[];
+    /** --force 覆盖项路径列表 */
+    forcedConflicts?: string[];
+    /** --force 覆盖项的 before/after 哈希；用于审计与回滚 */
+    forcedConflictHashes?: Record<string, {
+        before: string;
+        after: string;
+    }>;
+    /** 本次 sync 是否使用了 --force */
+    forced: boolean;
+    completedAt: string | null;
+}
+export interface ArchiveStageState {
+    archivedAt: string;
+    /** 归档目录绝对/相对路径 */
+    archivePath: string;
+    /** archive-summary.md 路径 */
+    summaryPath: string;
+    /** 是否使用了 --skip-sync-check */
+    skippedSyncCheck?: boolean;
+    /** 跳过原因（用户提供的注释或自动生成） */
+    skipSyncReason?: string;
+    /** 归档时刻的 sync 状态快照（无论是否 skip 都建议记录） */
+    syncSnapshot?: {
+        completedAt: string | null;
+        unresolvedConflicts: string[];
+        forcedConflicts: string[];
+    };
+    /** 风险记录；--skip-sync-check 必须写入对应说明 */
+    riskNotes?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/domains/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/domains/types.ts"],"names":[],"mappings":"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"}

package/dist/domains/types.js

@@ -0,0 +1,12 @@
+/**
+ * Domain Module Types
+ *
+ * 每个领域模块封装一组专业领域知识，在 specdo 工作流的各阶段自动注入：
+ *   explore → 领域触发信号 + 需求澄清问题
+ *   propose → 设计检查清单 + 模式推荐 + 反模式警示
+ *   apply   → 实施关注点 + 实施模式 + 常见错误
+ *   sync    → 领域审查清单
+ *   archive → 发布前验证清单
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domains/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/domains/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SpecDo — 不再暴露编程 API。
+ *
+ * 这是一个 CLI-first 工具：所有功能通过 `specdo` 命令访问，不再导出
+ * 任何 JS / TS 公共接口。本文件保留为空模块以保证 dist/index.js
+ * 仍可被旧 import 探测到（仅返回空对象）。
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * SpecDo — 不再暴露编程 API。
+ *
+ * 这是一个 CLI-first 工具：所有功能通过 `specdo` 命令访问，不再导出
+ * 任何 JS / TS 公共接口。本文件保留为空模块以保证 dist/index.js
+ * 仍可被旧 import 探测到（仅返回空对象）。
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/protocols/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Protocol Registry
+ *
+ * 协议（方法论型工作流）的注册中心。
+ *
+ * 与 ALL_DOMAINS 的关键区别:
+ *   - Protocol 不参与 scoreDomains 的领域排序
+ *   - 由命令层（Phase 2 的 apply 等）显式 import + 按需注入
+ *   - detectProtocolTriggers 仅提供显式短语检测；是否注入由命令层按架构边界决定
+ *
+ * 注册要求:
+ *   - protocol.name 在 ALL_PROTOCOLS 中必须唯一
+ *   - 协议内容修改不影响 DomainModule 的稳定性
+ */
+import type { Protocol } from '../domains/types.js';
+import { reviewToSolidProtocol } from './review-to-solid.js';
+/** 所有已注册的协议 */
+export declare const ALL_PROTOCOLS: Protocol[];
+/** 按名称查找协议 */
+export declare function getProtocolByName(name: string): Protocol | undefined;
+/**
+ * 判断输入文本是否命中协议的 triggerPhrases。
+ *
+ * 用于命令层在用户输入中检测协议显式触发，例如：
+ *   "Run review-to-solid on this proposal" → 命中 reviewToSolidProtocol
+ *
+ * 匹配规则: 大小写不敏感的子串匹配；若同一输入同时命中 suppressionPhrases，
+ * 或 doNotUseWhen 提炼出的负向短语，则不返回该协议，避免 copy-edit /
+ * review-only / quick-look 等场景误触发。
+ *
+ * @param input 用户原始输入文本
+ * @returns 命中的协议列表（可能为空）
+ */
+export declare function detectProtocolTriggers(input: string): Protocol[];
+export { reviewToSolidProtocol };
+//# sourceMappingURL=index.d.ts.map

package/dist/protocols/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocols/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,eAAe;AACf,eAAO,MAAM,aAAa,EAAE,QAAQ,EAEnC,CAAC;AAEF,cAAc;AACd,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAShE;AAwCD,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/protocols/index.js

@@ -0,0 +1,85 @@
+/**
+ * Protocol Registry
+ *
+ * 协议（方法论型工作流）的注册中心。
+ *
+ * 与 ALL_DOMAINS 的关键区别:
+ *   - Protocol 不参与 scoreDomains 的领域排序
+ *   - 由命令层（Phase 2 的 apply 等）显式 import + 按需注入
+ *   - detectProtocolTriggers 仅提供显式短语检测；是否注入由命令层按架构边界决定
+ *
+ * 注册要求:
+ *   - protocol.name 在 ALL_PROTOCOLS 中必须唯一
+ *   - 协议内容修改不影响 DomainModule 的稳定性
+ */
+import { reviewToSolidProtocol } from './review-to-solid.js';
+/** 所有已注册的协议 */
+export const ALL_PROTOCOLS = [
+    reviewToSolidProtocol,
+];
+/** 按名称查找协议 */
+export function getProtocolByName(name) {
+    return ALL_PROTOCOLS.find((p) => p.name === name);
+}
+/**
+ * 判断输入文本是否命中协议的 triggerPhrases。
+ *
+ * 用于命令层在用户输入中检测协议显式触发，例如：
+ *   "Run review-to-solid on this proposal" → 命中 reviewToSolidProtocol
+ *
+ * 匹配规则: 大小写不敏感的子串匹配；若同一输入同时命中 suppressionPhrases，
+ * 或 doNotUseWhen 提炼出的负向短语，则不返回该协议，避免 copy-edit /
+ * review-only / quick-look 等场景误触发。
+ *
+ * @param input 用户原始输入文本
+ * @returns 命中的协议列表（可能为空）
+ */
+export function detectProtocolTriggers(input) {
+    if (!input || input.trim().length === 0) {
+        return [];
+    }
+    const lowered = input.toLowerCase();
+    return ALL_PROTOCOLS.filter((protocol) => protocol.triggerPhrases.some((phrase) => lowered.includes(phrase.toLowerCase())) &&
+        !matchesProtocolSuppression(lowered, protocol));
+}
+function matchesProtocolSuppression(loweredInput, protocol) {
+    const suppressedPhrases = [
+        ...(protocol.suppressionPhrases ?? []),
+        ...extractDoNotUseSignals(protocol.doNotUseWhen),
+    ];
+    return suppressedPhrases.some((phrase) => loweredInput.includes(phrase));
+}
+function extractDoNotUseSignals(items) {
+    const signals = new Set();
+    for (const item of items) {
+        const lowered = item.toLowerCase();
+        for (const phrase of splitQuotedPhrases(lowered)) {
+            signals.add(phrase);
+        }
+        if (lowered.includes('single-line typo'))
+            signals.add('single-line typo');
+        if (lowered.includes('light review'))
+            signals.add('light review');
+        if (lowered.includes('quick "take a look"') || lowered.includes('quick take a look')) {
+            signals.add('quick take a look');
+            signals.add('take a quick look');
+            signals.add('take a look');
+        }
+        if (lowered.includes('review-only') || lowered.includes('review only')) {
+            signals.add('review-only');
+            signals.add('review only');
+        }
+        if (lowered.includes('polish wording'))
+            signals.add('polish wording');
+        if (lowered.includes('formatting fix'))
+            signals.add('formatting fix');
+    }
+    return [...signals];
+}
+function splitQuotedPhrases(input) {
+    return [...input.matchAll(/"([^"]+)"/g)]
+        .map((match) => match[1]?.trim())
+        .filter((phrase) => Boolean(phrase));
+}
+export { reviewToSolidProtocol };
+//# sourceMappingURL=index.js.map

package/dist/protocols/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocols/index.ts"],"names":[],"mappings":"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"}

package/dist/protocols/review-to-solid.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Review-To-Solid Protocol
+ *
+ * 来源: content/skills/review-to-solid/SKILL.md (463 行)
+ *
+ * 该协议是方法论型工作流，包含 DomainModule 无法表达的元素：
+ *   1. 7 步闭环工作流 + 步骤 4-5-6 循环回退（修复 → 再审 → 继续修复）
+ *   2. P1/P2/P3 严重度分级
+ *   3. 4 段强制输出契约（Final Verdict / Findings / Fix Summary / Delta Table）
+ *   4. 6 类工件分派（product / architecture / readme / pr / prompt-agent-skill / openspec）
+ *   5. 停止条件与禁止行为
+ *
+ * 设计决策（来自 Phase 1b POC）:
+ *   review-to-solid 不内嵌进 qualityDomain；保留为独立 Protocol，由 Phase 2 `apply` 命令
+ *   按需注入到 apply-brief.md 的 "Execution Discipline" 段。
+ *
+ * POC 决策证据表:
+ * | 证据 | DomainModule 是否可表达 | Protocol 保留方式 | Phase 1b 结论 |
+ * |------|-------------------------|-------------------|---------------|
+ * | 三层审查: 单工件 / 跨工件 / 生产级充分性 | 否。DomainModule 只有 stage 列表，不能表达审查顺序和层级覆盖要求 | workflow.step 3 actions | 独立 Protocol 保留执行顺序 |
+ * | P1/P2/P3 严重度影响是否继续修复 | 否。领域 checklist 不能驱动停止条件 | severityLevels + stopConditions | 独立 Protocol 可表达收敛门槛 |
+ * | 修复循环 review → fix → re-review → iterate | 否。DomainModule 无 loopBackTo 语义 | workflow.step 6 loopBackTo: [4, 5] | 独立 Protocol 保留闭环 |
+ * | Delta Table 是最终输出契约，不是领域知识 | 否。压进 DomainModule 会变成普通 checklist，无法保证输出段和列 | outputContract.Initial-vs-Final Delta Table | 独立 Protocol 满足 Phase 1b POC |
+ *
+ * 与 quality 域的关系:
+ *   quality 域提供"代码评审 / 调试 / 测试 / 性能 / 验证"的 checklist 知识；
+ *   review-to-solid 提供"如何把工件硬化到生产级"的执行纪律。
+ *   两者是知识 vs 流程，互不替代。
+ */
+import type { Protocol } from '../domains/types.js';
+export declare const reviewToSolidProtocol: Protocol;
+//# sourceMappingURL=review-to-solid.d.ts.map

package/dist/protocols/review-to-solid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-to-solid.d.ts","sourceRoot":"","sources":["../../src/protocols/review-to-solid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,eAAO,MAAM,qBAAqB,EAAE,QAmTnC,CAAC"}