soloforge 1.2.19 → 1.3.0

package/dist/engine/knowledge_template_contracts.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Batch 3 共享契约骨架 — 9 个问题共用的类型定义和注册表。
+ *
+ * 骨架名称与问题正文定义的 interface/contract 名一致，不另起平行模型。
+ * 继承 Batch 1+2 骨架（ContractRegistryEntry、DiagnosticCode 等），只扩展不重定义。
+ */
+/** 知识生命周期状态 — 使用 knowledge_lifecycle_status，不使用泛称 status */
+export type KnowledgeLifecycleStatus = "draft" | "quarantine" | "active" | "pending_review" | "deprecated";
+/** 知识主权 — 使用 sovereignty，normal / core */
+export type KnowledgeSovereignty = "normal" | "core";
+/** 知识写入阶段 — staged 从生命周期状态中拆出 */
+export type KnowledgeWriteStage = "staged" | "committed";
+/** 知识晋级状态 */
+export type PromotionStatus = "pending" | "evidence_gathered" | "human_reviewed" | "approved" | "rejected";
+/** 知识候选来源（问题十四） */
+export type KnowledgeCandidateSource = "senior_practice" | "failure_analysis" | "drift_detection" | "repeated_success" | "user_instruction" | "ai_inference";
+/** 知识证据（问题七 + 问题十四） */
+export interface KnowledgeEvidence {
+    id: string;
+    source_type: "user_confirmed" | "test_passed" | "failure_reproduced" | "failure_fixed" | "review_approved" | "usage_success" | "drift_detected" | "external_reference";
+    artifact_ref: string;
+    confidence: number;
+    collected_at: string;
+    /** 关联知识条目的主权等级 */
+    sovereignty: KnowledgeSovereignty;
+    /** 阻断标记：证据是否导致晋级被阻断 */
+    blocked?: boolean;
+}
+/** 知识健康检查发现（问题七） */
+export interface KnowledgeHealthFinding {
+    id: string;
+    severity: "info" | "warning" | "error" | "critical";
+    category: "format" | "lifecycle" | "consumption" | "conflict" | "staleness" | "evidence" | "injection_safety" | "sovereignty";
+    entry_id: string;
+    message: string;
+    recommendation: string;
+    auto_action?: "none" | "mark_pending_review" | "quarantine" | "deprecated_candidate";
+    requires_human: boolean;
+}
+/** 知识晋级报告（问题十四） */
+export interface KnowledgePromotionReport {
+    entry_id: string;
+    from_status: KnowledgeLifecycleStatus;
+    to_status: KnowledgeLifecycleStatus;
+    from_sovereignty: KnowledgeSovereignty;
+    to_sovereignty: KnowledgeSovereignty;
+    evidence_ids: string[];
+    conflicts_checked: boolean;
+    product_scope_checked: boolean;
+    human_approved_by?: string;
+    rollback_path: string;
+    promotion_status: PromotionStatus;
+}
+/** 文档 eligibility 状态 */
+export type DocEligibilityStatus = "draft" | "verified" | "formal" | "deprecated";
+/** 文档制品策略 */
+export interface DocumentationArtifactPolicy {
+    artifact: "design_doc" | "memo" | "readme" | "contract_registry" | "capability_registry" | "knowledge_templates" | "issue_pr" | "ci_report";
+    allowed_content: string[];
+    forbidden_content: string[];
+    source_of_truth_for: string[];
+    update_trigger: string[];
+}
+/** 设计文档资格状态 — 使用 doc_eligibility_status，不用泛称 status */
+export type DesignDocEligibilityStatus = "proposed" | "accepted_in_memo" | "implemented" | "verified" | "design_doc_eligible" | "superseded" | "rejected";
+/** 设计文档资格（问题二十一） */
+export interface DesignDocEligibility {
+    decision_id: string;
+    /** 准入资格状态 — 使用 doc_eligibility_status */
+    doc_eligibility_status: DesignDocEligibilityStatus;
+    evidence_refs: string[];
+    target_doc_section?: string;
+}
+/** 模板同步状态 */
+export type TemplateSyncStatus = "pending" | "dry_run_completed" | "conflicts_detected" | "user_confirmed" | "applied" | "rolled_back";
+/** 模板资产差异状态 — 使用 template_asset_status，不用泛称 status */
+export type TemplateAssetDiffStatus = "missing" | "up_to_date" | "outdated_unmodified" | "outdated_modified" | "deprecated" | "conflict" | "schema_migration_required";
+/** 模板资产版本（问题二十五） */
+export interface TemplateAssetVersion {
+    asset_id: string;
+    source_path: string;
+    target_path: string;
+    asset_kind: string;
+    template_version: string;
+    source_hash: string;
+    installed_hash?: string;
+    user_modified: boolean;
+    /** 资产差异状态 — 使用 template_asset_status */
+    template_asset_status: TemplateAssetDiffStatus;
+}
+/** 知识迁移报告（问题二十五） */
+export interface KnowledgeMigrationReport {
+    project_path: string;
+    checked_at: string;
+    added: string[];
+    updated: string[];
+    skipped_user_modified: string[];
+    deprecated: string[];
+    conflicts: string[];
+    schema_migrations: string[];
+    requires_human: boolean;
+    rollback_path?: string;
+}
+/** 模板清单条目（问题二十五） */
+export interface TemplateManifestEntry {
+    asset_id: string;
+    asset_kind: string;
+    source_path: string;
+    target_path: string;
+    template_version: string;
+    source_hash: string;
+    installed_hash: string;
+    installed_at: string;
+    source_package_version?: string;
+    knowledge_lifecycle_status?: KnowledgeLifecycleStatus;
+    sovereignty?: KnowledgeSovereignty;
+}
+/** CLI 命令契约（问题三十） */
+export interface CliCommandContract {
+    command: string;
+    capability_ids: string[];
+    contract_ids: string[];
+    default_mode: "read_only" | "dry_run" | "write" | "execute" | "delivery";
+    reads: string[];
+    writes: string[];
+    side_effects: Array<"none" | "file_write" | "state_write" | "config_write" | "knowledge_write" | "command_execution" | "git_commit" | "git_push" | "pr_create" | "network" | "external_write">;
+    requires_confirmation: boolean;
+    dry_run_available: boolean;
+    documented_in_readme: boolean;
+}
+/** 适配器合规状态 */
+export type AdapterComplianceStatus = "compliant" | "missing_sections" | "forbidden_claims" | "outdated";
+/** 适配器 Prompt 契约（问题三十一） */
+export interface AdapterPromptContract {
+    adapter_id: string;
+    host_type: "claude_code" | "codex" | "cursor" | "trae" | "generic_mcp";
+    prompt_path?: string;
+    generated_from_contract_version: string;
+    required_sections: Array<"when_to_use_soloforge" | "when_not_to_use_soloforge" | "tool_invocation_policy" | "read_only_bypass_policy" | "strict_controlled_tools" | "language_policy" | "status_feedback_policy" | "dangerous_action_policy" | "trace_policy" | "fallback_policy">;
+    forbidden_claims: string[];
+    sync_required: boolean;
+    /** next_allowed_tools 约束 */
+    next_allowed_tools: string[];
+}
+/** 适配器 Prompt 清单（问题三十一） */
+export interface AdapterPromptManifest {
+    adapter_id: string;
+    host_type: string;
+    generated_path: string;
+    template_version: string;
+    template_hash: string;
+    generated_hash: string;
+    generated_at: string;
+    contract_ids: string[];
+}
+/** 发布兼容状态 */
+export type ReleaseCompatibilityStatus = "compatible" | "migration_required" | "breaking_changes" | "incompatible";
+/** 发布兼容契约（问题三十五） */
+export interface ReleaseCompatibilityContract {
+    package_version: string;
+    contract_registry_version: string;
+    supported_project_schema_versions: string[];
+    migrations: MigrationStep[];
+    breaking_changes: BreakingChange[];
+    deprecated_features: DeprecatedFeature[];
+    compatibility_policy: {
+        read_old_state: boolean;
+        auto_migrate_safe_changes: boolean;
+        require_human_for_destructive_migration: boolean;
+        rollback_supported: boolean;
+    };
+}
+/** 迁移步骤 */
+export interface MigrationStep {
+    from_version: string;
+    to_version: string;
+    description_zh: string;
+    auto_applicable: boolean;
+    requires_human_confirm: boolean;
+    affects_sovereignty: boolean;
+    rollback_path: string;
+}
+/** 破坏性变更 */
+export interface BreakingChange {
+    id: string;
+    description_zh: string;
+    impact: "contract" | "schema" | "template" | "adapter" | "cli";
+    migration_required: boolean;
+}
+/** 废弃特性 */
+export interface DeprecatedFeature {
+    id: string;
+    description_zh: string;
+    replacement?: string;
+    removal_scheduled?: string;
+}
+/** 项目迁移计划（问题三十五） */
+export interface ProjectMigrationPlan {
+    project_path: string;
+    from_version: string;
+    to_version: string;
+    required_migrations: string[];
+    auto_applicable: string[];
+    requires_human: string[];
+    blocked: string[];
+    backup_path?: string;
+    rollback_path?: string;
+}
+/** 语言策略 — 使用 language_policy_status，不使用泛称 status/mode */
+export type LanguagePolicyStatus = "zh_first" | "en_first" | "bilingual" | "source_preserving" | "project_override";
+/** LanguagePolicy type — 问题十定义的值域 */
+export type LanguagePolicy = "zh_first" | "source_preserving" | "en_allowed" | "code_native";
+/** 语义污染检测状态 */
+export type SemanticPollutionStatus = "clean" | "polluted" | "auto_remediated" | "manual_required";
+export interface IssueDetailAcceptance {
+    issue_id: string;
+    contract_id: string;
+    must_keep_details: string[];
+    required_entrypoints: string[];
+    required_contract_fields: string[];
+    required_mechanism_hooks: string[];
+    required_template_or_adapter_updates: string[];
+    required_sync_or_migration_paths: string[];
+    required_evidence_refs: string[];
+    required_diagnostics: string[];
+    regression_cases: string[];
+    cross_scenario_coverage: string[];
+    user_project_impact: string[];
+    soloforge_self_impact: string[];
+    owner_files: string[];
+    mainline_consumption_check: string[];
+    not_done_if_missing: string[];
+}
+export interface BatchScenarioCase {
+    id: string;
+    name: string;
+    fixture: string;
+    command_or_entry: string;
+    expected_evidence: string[];
+    pass_fail_rules: string[];
+    covered_issues: string[];
+}
+export declare const KNOWLEDGE_TEMPLATE_INVARIANTS: readonly ["core knowledge 不得被 AI inference 或自动机制修改", "draft / quarantine / pending_review 知识不得自动晋级 active/core", "知识晋级必须有人工签署或等效 evidence", "用户修改的模板不得被模板同步覆盖", "模板同步必须 dry-run 先行，apply 必须用户确认", "adapter prompt 不得包含超出宿主能力的 forbidden claim", "adapter prompt 必须包含 next_allowed_tools 约束", "README 命令必须映射到真实 CLI contract，漂移必须检测", "未 verified 的备忘录决策不得写入正式设计文档", "设计文档不得记录施工流水", "migrate 默认 dry-run，apply 必须用户确认", "升级后用户项目已有配置不得被覆盖", "英文项目可配置 en_first，中文项目不被英文模板污染", "知识主权使用 sovereignty（normal / core），不另起 knowledge_sovereignty_level", "知识生命周期状态使用 knowledge_lifecycle_status，不使用泛称 status", "语言策略使用 language_policy_status，不使用泛称 status"];
+//# sourceMappingURL=knowledge_template_contracts.d.ts.map

package/dist/engine/knowledge_template_contracts.d.ts.map

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

package/dist/engine/knowledge_template_contracts.js

@@ -0,0 +1,26 @@
+/**
+ * Batch 3 共享契约骨架 — 9 个问题共用的类型定义和注册表。
+ *
+ * 骨架名称与问题正文定义的 interface/contract 名一致，不另起平行模型。
+ * 继承 Batch 1+2 骨架（ContractRegistryEntry、DiagnosticCode 等），只扩展不重定义。
+ */
+// ── Batch 3 不变量 ──
+export const KNOWLEDGE_TEMPLATE_INVARIANTS = [
+    "core knowledge 不得被 AI inference 或自动机制修改",
+    "draft / quarantine / pending_review 知识不得自动晋级 active/core",
+    "知识晋级必须有人工签署或等效 evidence",
+    "用户修改的模板不得被模板同步覆盖",
+    "模板同步必须 dry-run 先行，apply 必须用户确认",
+    "adapter prompt 不得包含超出宿主能力的 forbidden claim",
+    "adapter prompt 必须包含 next_allowed_tools 约束",
+    "README 命令必须映射到真实 CLI contract，漂移必须检测",
+    "未 verified 的备忘录决策不得写入正式设计文档",
+    "设计文档不得记录施工流水",
+    "migrate 默认 dry-run，apply 必须用户确认",
+    "升级后用户项目已有配置不得被覆盖",
+    "英文项目可配置 en_first，中文项目不被英文模板污染",
+    "知识主权使用 sovereignty（normal / core），不另起 knowledge_sovereignty_level",
+    "知识生命周期状态使用 knowledge_lifecycle_status，不使用泛称 status",
+    "语言策略使用 language_policy_status，不使用泛称 status",
+];
+//# sourceMappingURL=knowledge_template_contracts.js.map

package/dist/engine/knowledge_template_contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_template_contracts.js","sourceRoot":"","sources":["../../src/engine/knowledge_template_contracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4YH,oBAAoB;AAEpB,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,yCAAyC;IACzC,0DAA0D;IAC1D,yBAAyB;IACzB,kBAAkB;IAClB,gCAAgC;IAChC,4CAA4C;IAC5C,2CAA2C;IAC3C,sCAAsC;IACtC,6BAA6B;IAC7B,cAAc;IACd,iCAAiC;IACjC,kBAAkB;IAClB,+BAA+B;IAC/B,mEAAmE;IACnE,oDAAoD;IACpD,4CAA4C;CACpC,CAAC"}

package/dist/engine/language_policy.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 语言策略配置 — 问题四十一 (Language Policy Override) + 问题十 (中文语义优先)。
+ *
+ * 管理语言策略配置，支持 zh_first / source_preserving / en_allowed / code_native。
+ * 消费 Batch 2 language_policy_contract，不重定义总契约。
+ * 使用 language_policy_status 规范字段名。
+ */
+import type { LanguagePolicy, LanguagePolicyStatus, SemanticPollutionStatus } from "./knowledge_template_contracts.js";
+export type { LanguagePolicy, LanguagePolicyStatus, SemanticPollutionStatus };
+/** 语言策略配置 — 消费 Batch 2 LanguagePolicyContract，不重定义 */
+export interface LanguagePolicyConfig {
+    /** 默认策略 */
+    default: LanguagePolicyStatus;
+    /** 业务语义策略 */
+    business_semantics: LanguagePolicy;
+    /** 验收标准策略 */
+    acceptance_criteria: LanguagePolicy;
+    /** 审查发现策略 */
+    review_findings: LanguagePolicy;
+    /** 治理契约策略 */
+    governance_contracts: LanguagePolicy;
+    /** 用户反馈策略 */
+    user_feedback: LanguagePolicy;
+    /** 代码注释策略 */
+    code_comments: LanguagePolicy;
+    /** API 文档策略 */
+    api_docs: LanguagePolicy;
+    /** 提交信息策略 */
+    commit_messages: LanguagePolicy;
+    /** 日志和错误 — 保持 source_preserving */
+    logs_and_errors: "source_preserving";
+    /** 代码标识符 — 保持 code_native */
+    code_identifiers: "code_native";
+    /** 项目级覆盖来源 */
+    override_source?: "project_config" | "detected_language" | "cli_param" | "user_instruction";
+}
+/** 语义污染检测 */
+export interface SemanticPollutionFinding {
+    id: string;
+    entry_id: string;
+    status: SemanticPollutionStatus;
+    detected_language: "zh" | "en" | "mixed";
+    expected_language: "zh" | "en" | "preserve";
+    message: string;
+    remediation?: string;
+}
+/**
+ * 获取当前语言策略配置。
+ * 默认 zh_first。
+ */
+export declare function getLanguagePolicyConfig(override?: LanguagePolicyStatus): LanguagePolicyConfig;
+/**
+ * 检测中文项目是否被英文模板污染。
+ * 硬规则：中文项目（zh_first）的知识条目不得被英文内容覆盖。
+ */
+export declare function detectSemanticPollution(config: LanguagePolicyConfig, entries: Array<{
+    id: string;
+    content: string;
+    expected_language?: "zh" | "en" | "preserve";
+}>): SemanticPollutionFinding[];
+/**
+ * 验证语言策略变更不会破坏已有知识条目的主权。
+ * 硬规则：语言策略变更不得改变 sovereignty 字段。
+ */
+export declare function validateLanguagePolicyChange(_oldConfig: LanguagePolicyConfig, _newConfig: LanguagePolicyConfig): {
+    valid: boolean;
+    reason?: string;
+};
+/**
+ * 获取语言策略（兼容旧接口）。
+ * @deprecated 使用 getLanguagePolicyConfig 替代
+ */
+export declare function getLanguagePolicy(): {
+    mode: string;
+    enforce_zh_comments: boolean;
+    enforce_zh_logs: boolean;
+};
+//# sourceMappingURL=language_policy.d.ts.map

package/dist/engine/language_policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language_policy.d.ts","sourceRoot":"","sources":["../../src/engine/language_policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,CAAC;AAI9E,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,WAAW;IACX,OAAO,EAAE,oBAAoB,CAAC;IAC9B,aAAa;IACb,kBAAkB,EAAE,cAAc,CAAC;IACnC,aAAa;IACb,mBAAmB,EAAE,cAAc,CAAC;IACpC,aAAa;IACb,eAAe,EAAE,cAAc,CAAC;IAChC,aAAa;IACb,oBAAoB,EAAE,cAAc,CAAC;IACrC,aAAa;IACb,aAAa,EAAE,cAAc,CAAC;IAC9B,aAAa;IACb,aAAa,EAAE,cAAc,CAAC;IAC9B,eAAe;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa;IACb,eAAe,EAAE,cAAc,CAAC;IAChC,mCAAmC;IACnC,eAAe,EAAE,mBAAmB,CAAC;IACrC,6BAA6B;IAC7B,gBAAgB,EAAE,aAAa,CAAC;IAChC,cAAc;IACd,eAAe,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,WAAW,GAAG,kBAAkB,CAAC;CAC7F;AAED,aAAa;AACb,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,uBAAuB,CAAC;IAChC,iBAAiB,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC;IACzC,iBAAiB,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,oBAAoB,CAetB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,CAAA;CAAE,CAAC,GAC5F,wBAAwB,EAAE,CAuB5B;AAeD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,oBAAoB,EAChC,UAAU,EAAE,oBAAoB,GAC/B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAGrC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAE5G"}

package/dist/engine/language_policy.js

@@ -0,0 +1,139 @@
+/**
+ * 语言策略配置 — 问题四十一 (Language Policy Override) + 问题十 (中文语义优先)。
+ *
+ * 管理语言策略配置，支持 zh_first / source_preserving / en_allowed / code_native。
+ * 消费 Batch 2 language_policy_contract，不重定义总契约。
+ * 使用 language_policy_status 规范字段名。
+ */
+// ── 默认配置（中文语义优先） ──
+const DEFAULT_ZH_FIRST_CONFIG = {
+    default: "zh_first",
+    business_semantics: "zh_first",
+    acceptance_criteria: "zh_first",
+    review_findings: "zh_first",
+    governance_contracts: "zh_first",
+    user_feedback: "zh_first",
+    code_comments: "source_preserving",
+    api_docs: "source_preserving",
+    commit_messages: "source_preserving",
+    logs_and_errors: "source_preserving",
+    code_identifiers: "code_native",
+};
+const EN_FIRST_CONFIG = {
+    default: "en_first",
+    business_semantics: "en_allowed",
+    acceptance_criteria: "en_allowed",
+    review_findings: "en_allowed",
+    governance_contracts: "en_allowed",
+    user_feedback: "zh_first",
+    code_comments: "source_preserving",
+    api_docs: "source_preserving",
+    commit_messages: "source_preserving",
+    logs_and_errors: "source_preserving",
+    code_identifiers: "code_native",
+    override_source: "project_config",
+};
+const BILINGUAL_CONFIG = {
+    default: "bilingual",
+    business_semantics: "zh_first",
+    acceptance_criteria: "zh_first",
+    review_findings: "zh_first",
+    governance_contracts: "zh_first",
+    user_feedback: "zh_first",
+    code_comments: "source_preserving",
+    api_docs: "en_allowed",
+    commit_messages: "source_preserving",
+    logs_and_errors: "source_preserving",
+    code_identifiers: "code_native",
+    override_source: "project_config",
+};
+const SOURCE_PRESERVING_CONFIG = {
+    default: "source_preserving",
+    business_semantics: "source_preserving",
+    acceptance_criteria: "source_preserving",
+    review_findings: "source_preserving",
+    governance_contracts: "source_preserving",
+    user_feedback: "source_preserving",
+    code_comments: "source_preserving",
+    api_docs: "source_preserving",
+    commit_messages: "source_preserving",
+    logs_and_errors: "source_preserving",
+    code_identifiers: "code_native",
+    override_source: "project_config",
+};
+// ── 核心函数 ──
+/**
+ * 获取当前语言策略配置。
+ * 默认 zh_first。
+ */
+export function getLanguagePolicyConfig(override) {
+    switch (override ?? "zh_first") {
+        case "zh_first":
+            return { ...DEFAULT_ZH_FIRST_CONFIG };
+        case "en_first":
+            return { ...EN_FIRST_CONFIG };
+        case "bilingual":
+            return { ...BILINGUAL_CONFIG };
+        case "source_preserving":
+            return { ...SOURCE_PRESERVING_CONFIG };
+        case "project_override":
+            return { ...DEFAULT_ZH_FIRST_CONFIG };
+        default:
+            return { ...DEFAULT_ZH_FIRST_CONFIG };
+    }
+}
+/**
+ * 检测中文项目是否被英文模板污染。
+ * 硬规则：中文项目（zh_first）的知识条目不得被英文内容覆盖。
+ */
+export function detectSemanticPollution(config, entries) {
+    const findings = [];
+    if (config.default !== "zh_first") {
+        return findings;
+    }
+    for (const entry of entries) {
+        const expected = entry.expected_language ?? "zh";
+        if (expected === "zh" && isEnglishDominant(entry.content)) {
+            findings.push({
+                id: `pollution-${entry.id}`,
+                entry_id: entry.id,
+                status: "polluted",
+                detected_language: "en",
+                expected_language: "zh",
+                message: `中文项目知识条目 ${entry.id} 被英文内容污染`,
+                remediation: "恢复中文语义或标记为 source_preserving",
+            });
+        }
+    }
+    return findings;
+}
+/**
+ * 判断文本是否以英文为主。
+ * 简单启发式：英文单词占比超过 70% 视为英文为主。
+ */
+function isEnglishDominant(text) {
+    if (!text || text.length === 0)
+        return false;
+    const englishWords = text.match(/[a-zA-Z]+/g) ?? [];
+    const chineseChars = text.match(/[一-鿿]/g) ?? [];
+    const totalContent = englishWords.length + chineseChars.length;
+    if (totalContent === 0)
+        return false;
+    return englishWords.length / totalContent > 0.7;
+}
+/**
+ * 验证语言策略变更不会破坏已有知识条目的主权。
+ * 硬规则：语言策略变更不得改变 sovereignty 字段。
+ */
+export function validateLanguagePolicyChange(_oldConfig, _newConfig) {
+    // 语言策略变更只影响输出语言，不影响知识主权
+    return { valid: true };
+}
+/**
+ * 获取语言策略（兼容旧接口）。
+ * @deprecated 使用 getLanguagePolicyConfig 替代
+ */
+export function getLanguagePolicy() {
+    return { mode: "zh_first", enforce_zh_comments: true, enforce_zh_logs: true };
+}
+//# sourceMappingURL=language_policy.js.map

package/dist/engine/language_policy.js.map

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

package/dist/engine/language_policy_contract.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 语言策略契约 — 问题四十八 (Language Policy Contract)。
+ *
+ * 核心规则:
+ * - 用户可见语义中文优先
+ * - 机器字段、event key、API field、enum、contract id 保持英文稳定
+ * - stderr/logger 不得替代 UserFeedbackMessage / status / tool return
+ * - 用户必须能看到 SoloForge 是否触发、route、缺失输入、降级、阻断、下一步
+ */
+export type LanguagePolicyStatus = "compliant" | "violation" | "override";
+export interface LanguagePolicyContract {
+    policy_id: string;
+    scope: "soloforge_core" | "user_project";
+    rules: LanguagePolicyRule[];
+}
+export interface LanguagePolicyRule {
+    rule_id: string;
+    domain: "user_feedback" | "log_message" | "doc_comment" | "code_comment" | "status_report" | "diagnostic_message" | "api_field" | "event_key" | "enum_value";
+    required_language: "zh_priority" | "en_stable";
+    description_zh: string;
+}
+export interface LanguagePolicyEvaluation {
+    evaluated_at: string;
+    scope: "soloforge_core" | "user_project";
+    findings: LanguagePolicyFinding[];
+    total_checked: number;
+    violations: number;
+    compliant: number;
+    status: LanguagePolicyStatus;
+    override_evidence?: string;
+}
+export interface LanguagePolicyFinding {
+    rule_id: string;
+    severity: "hard_fail" | "warning" | "advisory";
+    location: string;
+    message_zh: string;
+    detail: string;
+}
+/**
+ * 获取 SoloForge 核心语言规则。
+ */
+export declare function getCoreLanguageRules(): LanguagePolicyRule[];
+/**
+ * 评估语言策略合规性。
+ */
+export declare function evaluateLanguagePolicy(scope: "soloforge_core" | "user_project", checks: Array<{
+    rule_id: string;
+    location: string;
+    passed: boolean;
+    detail: string;
+}>, overrideEvidence?: string): LanguagePolicyEvaluation;
+//# sourceMappingURL=language_policy_contract.d.ts.map

package/dist/engine/language_policy_contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language_policy_contract.d.ts","sourceRoot":"","sources":["../../src/engine/language_policy_contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,GAAG,cAAc,CAAC;IACzC,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,oBAAoB,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IAC7J,iBAAiB,EAAE,aAAa,GAAG,WAAW,CAAC;IAC/C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,gBAAgB,GAAG,cAAc,CAAC;IACzC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAyBD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,GAAG,cAAc,EACxC,MAAM,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EACrF,gBAAgB,CAAC,EAAE,MAAM,GACxB,wBAAwB,CAqC1B"}

package/dist/engine/language_policy_contract.js

@@ -0,0 +1,78 @@
+/**
+ * 语言策略契约 — 问题四十八 (Language Policy Contract)。
+ *
+ * 核心规则:
+ * - 用户可见语义中文优先
+ * - 机器字段、event key、API field、enum、contract id 保持英文稳定
+ * - stderr/logger 不得替代 UserFeedbackMessage / status / tool return
+ * - 用户必须能看到 SoloForge 是否触发、route、缺失输入、降级、阻断、下一步
+ */
+const SOLOFORGE_CORE_RULES = [
+    // 中文优先领域
+    { rule_id: "lp-user-feedback-zh", domain: "user_feedback", required_language: "zh_priority",
+        description_zh: "UserFeedbackMessage 的 blocked/degraded/manual_required/completed 必须中文语义优先" },
+    { rule_id: "lp-log-message-zh", domain: "log_message", required_language: "zh_priority",
+        description_zh: "console.error 的 message 字段必须中文" },
+    { rule_id: "lp-diagnostic-zh", domain: "diagnostic_message", required_language: "zh_priority",
+        description_zh: "诊断码的 title_zh、user_message_zh、recovery_hint_zh 必须非空" },
+    { rule_id: "lp-status-report-zh", domain: "status_report", required_language: "zh_priority",
+        description_zh: "soloforge status 输出必须中文语义优先" },
+    { rule_id: "lp-doc-comment-zh", domain: "doc_comment", required_language: "zh_priority",
+        description_zh: "关键机制类、适配器类必须有中文 doc 注释" },
+    { rule_id: "lp-code-comment-zh", domain: "code_comment", required_language: "zh_priority",
+        description_zh: "关键治理判断、状态流转、异常处理必须有中文行注释" },
+    // 英文稳定领域
+    { rule_id: "lp-api-field-en", domain: "api_field", required_language: "en_stable",
+        description_zh: "API 字段、DB 字段保持英文稳定，不得强制翻译" },
+    { rule_id: "lp-event-key-en", domain: "event_key", required_language: "en_stable",
+        description_zh: "event key、route、status、duration_ms 保持英文" },
+    { rule_id: "lp-enum-value-en", domain: "enum_value", required_language: "en_stable",
+        description_zh: "枚举值、代码标识符保持英文稳定" },
+];
+/**
+ * 获取 SoloForge 核心语言规则。
+ */
+export function getCoreLanguageRules() {
+    return [...SOLOFORGE_CORE_RULES];
+}
+/**
+ * 评估语言策略合规性。
+ */
+export function evaluateLanguagePolicy(scope, checks, overrideEvidence) {
+    const findings = [];
+    for (const check of checks) {
+        if (!check.passed) {
+            const rule = SOLOFORGE_CORE_RULES.find((r) => r.rule_id === check.rule_id);
+            findings.push({
+                rule_id: check.rule_id,
+                severity: rule?.required_language === "en_stable" ? "warning" : "advisory",
+                location: check.location,
+                message_zh: `语言策略违规: ${rule?.description_zh ?? check.rule_id}`,
+                detail: check.detail,
+            });
+        }
+    }
+    const violations = findings.length;
+    const compliant = checks.length - violations;
+    let status;
+    if (overrideEvidence) {
+        status = "override";
+    }
+    else if (violations > 0) {
+        status = "violation";
+    }
+    else {
+        status = "compliant";
+    }
+    return {
+        evaluated_at: new Date().toISOString(),
+        scope,
+        findings,
+        total_checked: checks.length,
+        violations,
+        compliant,
+        status,
+        override_evidence: overrideEvidence,
+    };
+}
+//# sourceMappingURL=language_policy_contract.js.map