@winspan/claude-forge 8.41.0 → 8.51.0

package/dist/engine/agent-router.js

@@ -1,276 +0,0 @@
-/**
- * AgentRouter — matches classifier output against a YAML routing table and
- * decides whether to route to an agent, a skill, or let the default flow
- * continue.
- *
- * Deliberately independent from RuleEngine:
- *   - RuleEngine handles governance decisions (block/warn/confirm) on tool use
- *   - AgentRouter handles intent-to-agent/skill routing at UserPromptSubmit
- *
- * Both share the Convention-YAML ethos but have different context shapes and
- * action semantics, so coupling them through RuleEngine would leak types.
- *
- * Routing YAML format (engine/conventions/routing.yaml):
- *
- *   schemaVersion: "1.0"
- *   rules:
- *     - when: { taskType: build_system }
- *       action: { type: route_to_agent, name: full-system-builder }
- *     - when: { taskType: add_feature, complexity: [moderate, complex] }
- *       action: { type: route_to_agent, name: feature-developer }
- *     - when: { default: true }
- *       action: { type: route_to_skill, strategy: best_match }
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { homedir } from 'node:os';
-import { fileURLToPath } from 'node:url';
-import yaml from 'js-yaml';
-import { logger } from '../core/utils/logger.js';
-// -- Defaults (hardcoded fallback for when YAML is missing/broken) --
-const FALLBACK_RULES = [
-    { when: { default: true }, action: { type: 'route_to_skill', strategy: 'best_match' } },
-];
-export class AgentRouter {
-    rules = FALLBACK_RULES;
-    sourceLabel = 'fallback';
-    userPath;
-    defaultPath;
-    watcher = null;
-    isRuleDisabled = null;
-    /**
-     * Load routing rules from:
-     *   1. Inline rules (if provided) — skips disk load, used by ExperimentRouter
-     *   2. User override:   ~/.claude-forge/routing.yaml
-     *   3. Default:         engine/conventions/routing.yaml (shipped)
-     *   4. Fallback:        FALLBACK_RULES (always route to skill)
-     *
-     * If `isRuleDisabled` is provided, decide() will skip any rule whose
-     * (taskType, agent) pair is currently flagged disabled.
-     */
-    constructor(opts = {}) {
-        this.userPath = opts.userPath ?? path.join(homedir(), '.claude-forge', 'routing.yaml');
-        this.defaultPath = opts.defaultPath ?? this.resolveShippedDefault();
-        this.isRuleDisabled = opts.isRuleDisabled ?? null;
-        if (opts.rules && opts.rules.length > 0) {
-            this.rules = opts.rules.filter(isValidRule);
-            this.sourceLabel = 'yaml';
-        }
-        else {
-            this.load();
-        }
-    }
-    /** Allow late binding (used by ExperimentRouter per-group routers). */
-    setIsRuleDisabled(fn) {
-        this.isRuleDisabled = fn;
-    }
-    /**
-     * (Re)load routing rules from disk. Called by constructor and hot-reload watcher.
-     */
-    load() {
-        const loaded = this.tryLoad(this.userPath, 'user override') ??
-            this.tryLoad(this.defaultPath, 'shipped default');
-        if (loaded && loaded.length > 0) {
-            this.rules = loaded;
-            this.sourceLabel = 'yaml';
-            logger.info(`[AgentRouter] Loaded ${loaded.length} routing rule(s)`);
-        }
-        else {
-            this.rules = FALLBACK_RULES;
-            this.sourceLabel = 'fallback';
-            logger.warn('[AgentRouter] No routing YAML found, using fallback');
-        }
-    }
-    /**
-     * Enable hot-reload: watch user override file for changes and auto-reload.
-     * Safe to call multiple times (idempotent).
-     */
-    enableHotReload() {
-        if (this.watcher)
-            return; // already watching
-        const watchPath = this.userPath;
-        const watchDir = path.dirname(watchPath);
-        // Watch the directory (not the file) to catch create/delete/rename
-        if (!fs.existsSync(watchDir)) {
-            logger.debug(`[AgentRouter] Hot-reload skipped: ${watchDir} does not exist`);
-            return;
-        }
-        try {
-            this.watcher = fs.watch(watchDir, (eventType, filename) => {
-                if (filename === path.basename(watchPath)) {
-                    logger.info(`[AgentRouter] Detected change in ${watchPath}, reloading...`);
-                    this.load();
-                }
-            });
-            logger.info(`[AgentRouter] Hot-reload enabled for ${watchPath}`);
-        }
-        catch (err) {
-            logger.warn(`[AgentRouter] Failed to enable hot-reload: ${err}`);
-        }
-    }
-    /**
-     * Disable hot-reload watcher (cleanup on daemon shutdown).
-     */
-    disableHotReload() {
-        if (this.watcher) {
-            this.watcher.close();
-            this.watcher = null;
-            logger.info('[AgentRouter] Hot-reload disabled');
-        }
-    }
-    resolveShippedDefault() {
-        // When running from dist/, __filename resolves into dist/engine/.
-        // The conventions dir is sibling to this file in both dev and build layouts.
-        try {
-            const here = fileURLToPath(import.meta.url);
-            return path.join(path.dirname(here), 'conventions', 'routing.yaml');
-        }
-        catch {
-            return path.resolve(process.cwd(), 'src/engine/conventions/routing.yaml');
-        }
-    }
-    tryLoad(filePath, label) {
-        if (!fs.existsSync(filePath))
-            return null;
-        try {
-            const raw = fs.readFileSync(filePath, 'utf-8');
-            const parsed = yaml.load(raw);
-            if (!parsed || !Array.isArray(parsed.rules) || parsed.rules.length === 0) {
-                logger.warn(`[AgentRouter] ${label} has no rules: ${filePath}`);
-                return null;
-            }
-            return parsed.rules.filter(isValidRule);
-        }
-        catch (err) {
-            logger.warn(`[AgentRouter] Failed to parse ${label} (${filePath}): ${err}`);
-            return null;
-        }
-    }
-    decide(input) {
-        // Primary pass: match on full input (taskType + complexity + optional V2 axes)
-        const primary = this.tryDecide(input);
-        if (primary.action.type !== 'none')
-            return primary;
-        // V2 candidate fallback: if input.candidates is provided and primary
-        // produced `none`, try each candidate (sorted by confidence desc) as a
-        // synthetic RouteInput. First non-`none` match wins. This lets the CoT
-        // classifier's secondary candidates rescue routing when the primary
-        // intent has no agent mapping (e.g. obscure action verbs).
-        if (input.candidates && input.candidates.length > 0) {
-            const sorted = [...input.candidates].sort((a, b) => b.confidence - a.confidence);
-            for (const cand of sorted) {
-                // Skip candidates that match the primary intent verbatim — they would
-                // re-produce the same `none` decision.
-                if (cand.taskType === input.taskType && cand.action === input.action)
-                    continue;
-                const synthetic = {
-                    taskType: cand.taskType,
-                    complexity: input.complexity,
-                };
-                if (cand.action !== undefined)
-                    synthetic.action = cand.action;
-                // domain / artifact are dropped — candidates only carry action+taskType
-                const alt = this.tryDecide(synthetic);
-                if (alt.action.type !== 'none') {
-                    logger.debug(`[AgentRouter] Candidate fallback matched taskType=${cand.taskType} ` +
-                        `action=${cand.action ?? '-'} (confidence=${cand.confidence.toFixed(2)})`);
-                    return alt;
-                }
-            }
-        }
-        return primary;
-    }
-    tryDecide(input) {
-        for (let i = 0; i < this.rules.length; i++) {
-            const rule = this.rules[i];
-            if (!matchWhen(rule.when, input))
-                continue;
-            if (this.isRuleDisabled && rule.action.type === 'route_to_agent') {
-                if (this.isRuleDisabled(input.taskType, rule.action.name))
-                    continue;
-            }
-            return {
-                action: rule.action,
-                matchedRuleIndex: i,
-                source: this.sourceLabel,
-            };
-        }
-        return {
-            action: { type: 'none' },
-            matchedRuleIndex: null,
-            source: this.sourceLabel,
-        };
-    }
-    /** Exposed for Web UI "路由调优" panel. */
-    getRules() {
-        return this.rules.slice();
-    }
-}
-// -- Helpers --
-function matchWhen(when, input) {
-    if (when.default === true)
-        return true;
-    if (when.taskType !== undefined) {
-        const expected = Array.isArray(when.taskType) ? when.taskType : [when.taskType];
-        if (!expected.includes(input.taskType))
-            return false;
-    }
-    if (when.complexity !== undefined) {
-        const expected = Array.isArray(when.complexity)
-            ? when.complexity
-            : [when.complexity];
-        if (!expected.includes(input.complexity))
-            return false;
-    }
-    // V2 axes — only matched when both the rule AND the input carry the field.
-    // If the rule asks for an action/domain/artifact but the input has none,
-    // the rule fails to match (rules are stricter than input).
-    if (when.action !== undefined) {
-        if (input.action === undefined)
-            return false;
-        const expected = Array.isArray(when.action) ? when.action : [when.action];
-        if (!expected.includes(input.action))
-            return false;
-    }
-    if (when.domain !== undefined) {
-        if (input.domain === undefined)
-            return false;
-        const expected = Array.isArray(when.domain) ? when.domain : [when.domain];
-        if (!expected.includes(input.domain))
-            return false;
-    }
-    if (when.artifact !== undefined) {
-        if (input.artifact === undefined)
-            return false;
-        const expected = Array.isArray(when.artifact) ? when.artifact : [when.artifact];
-        if (!expected.includes(input.artifact))
-            return false;
-    }
-    return true;
-}
-function isValidRule(r) {
-    if (!r || typeof r !== 'object')
-        return false;
-    const rule = r;
-    if (!rule.when || typeof rule.when !== 'object')
-        return false;
-    if (!rule.action || typeof rule.action !== 'object')
-        return false;
-    const action = rule.action;
-    const type = action.type;
-    if (type === 'route_to_agent_group') {
-        // Validate agents array structure
-        if (!Array.isArray(action.agents) || action.agents.length === 0)
-            return false;
-        return action.agents.every((a) => a &&
-            typeof a === 'object' &&
-            'name' in a &&
-            'focus' in a &&
-            typeof a.name === 'string' &&
-            typeof a.focus === 'string');
-    }
-    return (type === 'route_to_agent' ||
-        type === 'route_to_skill' ||
-        type === 'none');
-}
-//# sourceMappingURL=agent-router.js.map

package/dist/engine/agent-router.js.map

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

package/dist/engine/context-builder.d.ts

@@ -1,23 +0,0 @@
-/**
- * ContextBuilder — builds RuleContext from ForgeEvent
- *
- * Constructs DSL evaluation context from Claude Code hook events and session state.
- */
-import type { ForgeEvent } from '../core/types.js';
-import type { RuleContext, ToolEvent } from './dsl/types.js';
-import type { EvidenceStore } from './evidence-store.js';
-export interface ContextBuilderOptions {
-    sessionStartTime: number;
-    sessionPhase?: string;
-    gitBranch?: string;
-    hasUncommitted?: boolean;
-    variables?: Record<string, unknown>;
-}
-export declare class ContextBuilder {
-    private evidenceStore;
-    constructor(evidenceStore: EvidenceStore);
-    build(event: ForgeEvent, options: ContextBuilderOptions): RuleContext;
-    toToolEvent(event: ForgeEvent, success?: boolean, error?: string): ToolEvent;
-    private extractFilePath;
-}
-//# sourceMappingURL=context-builder.d.ts.map

package/dist/engine/context-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/engine/context-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhD,KAAK,CACH,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,qBAAqB,GAC7B,WAAW;IAoCd,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,UAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS;IAUzE,OAAO,CAAC,eAAe;CAexB"}

package/dist/engine/context-builder.js

@@ -1,63 +0,0 @@
-/**
- * ContextBuilder — builds RuleContext from ForgeEvent
- *
- * Constructs DSL evaluation context from Claude Code hook events and session state.
- */
-import path from 'node:path';
-export class ContextBuilder {
-    evidenceStore;
-    constructor(evidenceStore) {
-        this.evidenceStore = evidenceStore;
-    }
-    build(event, options) {
-        const toolName = event.tool_name ?? '';
-        const toolInput = event.tool_input ?? {};
-        const filePath = this.extractFilePath(toolName, toolInput);
-        const stats = this.evidenceStore.getStats(event.session_id);
-        return {
-            tool: toolName,
-            args: toolInput,
-            file_path: filePath,
-            file_ext: filePath ? path.extname(filePath) : null,
-            file_dir: filePath ? path.dirname(filePath) : null,
-            session: {
-                id: event.session_id,
-                phase: options.sessionPhase ?? 'implementation',
-                duration_minutes: Math.floor((Date.now() - options.sessionStartTime) / 60000),
-            },
-            git: {
-                branch: options.gitBranch ?? 'main',
-                has_uncommitted: options.hasUncommitted ?? false,
-            },
-            history: {
-                last: (n) => this.evidenceStore.getLastEvents(event.session_id, n),
-                consecutive_failures: stats.consecutive_failures,
-                file_changes: stats.file_changes,
-                tool_calls: stats.tool_calls,
-            },
-            vars: options.variables ?? {},
-        };
-    }
-    toToolEvent(event, success = true, error) {
-        return {
-            tool: event.tool_name ?? '',
-            args: event.tool_input ?? {},
-            success,
-            error,
-            timestamp: Date.now(),
-        };
-    }
-    extractFilePath(toolName, toolInput) {
-        switch (toolName) {
-            case 'Write':
-            case 'Edit':
-            case 'Read':
-                return toolInput.file_path ?? null;
-            case 'NotebookEdit':
-                return toolInput.notebook_path ?? null;
-            default:
-                return null;
-        }
-    }
-}
-//# sourceMappingURL=context-builder.js.map

package/dist/engine/context-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../src/engine/context-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CACH,KAAiB,EACjB,OAA8B;QAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;QACvC,MAAM,SAAS,GAAI,KAAK,CAAC,UAAsC,IAAI,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE5D,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,SAAS;YAEf,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;YAClD,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;YAElD,OAAO,EAAE;gBACP,EAAE,EAAE,KAAK,CAAC,UAAU;gBACpB,KAAK,EAAE,OAAO,CAAC,YAAY,IAAI,gBAAgB;gBAC/C,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC;aAC9E;YAED,GAAG,EAAE;gBACH,MAAM,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;gBACnC,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,KAAK;aACjD;YAED,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC1E,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;gBAChD,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B;YAED,IAAI,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;SAC9B,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,KAAiB,EAAE,OAAO,GAAG,IAAI,EAAE,KAAc;QAC3D,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;YAC3B,IAAI,EAAG,KAAK,CAAC,UAAsC,IAAI,EAAE;YACzD,OAAO;YACP,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAEO,eAAe,CACrB,QAAgB,EAChB,SAAkC;QAElC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,OAAO,CAAC;YACb,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM;gBACT,OAAQ,SAAS,CAAC,SAAoB,IAAI,IAAI,CAAC;YACjD,KAAK,cAAc;gBACjB,OAAQ,SAAS,CAAC,aAAwB,IAAI,IAAI,CAAC;YACrD;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;CACF"}

package/dist/engine/conventions/basic-security.yaml

@@ -1,109 +0,0 @@
-id: "basic-security"
-name: "基础安全规范"
-version: "1.0.0"
-description: "通用安全规则，适用于所有项目"
-triggers: ["rm", "delete", "删除", "drop", "chmod", "sudo", "密钥", "secret", "password"]
-
-variables:
-  protected_branches: ["main", "master", "production", "staging"]
-  sensitive_files: [".env", ".env.local", ".env.production", "credentials.json", "secrets.yaml"]
-
-forbidden:
-  - id: "no-force-push-protected"
-    when: |
-      tool == "Bash"
-      && args.command.match(/git\s+push.*--force/).ok()
-      && git.branch.in(vars.protected_branches)
-    level: block
-    message: "禁止强制推送到受保护分支 {{git.branch}}"
-    suggestion: "使用 --force-with-lease 或创建新分支"
-    operator_guidance: "Git 安全规范：受保护分支禁止强制推送；如需改写历史，请在新分支完成并通过 PR 合并。"
-    doc_ref: "CLAUDE.md#Git 安全规范"
-    tags: ["git", "protected-branch", "history-rewrite"]
-
-  - id: "warn-force-push"
-    when: |
-      tool == "Bash"
-      && args.command.match(/git\s+push.*--force/).ok()
-      && !git.branch.in(vars.protected_branches)
-    level: warn
-    message: "检测到 git push --force，请确认这是有意为之"
-    suggestion: "force push 会覆盖远程仓库的提交历史"
-    operator_guidance: "优先使用 --force-with-lease，避免覆盖他人刚推送的提交。"
-    doc_ref: "CLAUDE.md#Git 安全规范"
-    tags: ["git", "force-push"]
-
-  - id: "no-rm-rf-root"
-    when: |
-      tool == "Bash"
-      && args.command.match(/rm\s+-[^\s]*r[^\s]*f[^\s]*\s+\//).ok()
-    level: block
-    message: "禁止 rm -rf / 操作"
-    operator_guidance: "这是不可逆的高危删除命令；先缩小目标路径，并用 ls 或 dry-run 确认作用范围。"
-    doc_ref: "CLAUDE.md#基础安全规范"
-    tags: ["filesystem", "destructive"]
-
-  - id: "no-sudo-rm"
-    when: |
-      tool == "Bash"
-      && args.command.match(/sudo\s+rm\s+-[^\s]*r/).ok()
-    level: block
-    message: "禁止 sudo rm -r 操作"
-
-  - id: "no-chmod-777"
-    when: |
-      tool == "Bash"
-      && args.command.match(/chmod\s+777/).ok()
-    level: block
-    message: "禁止设置 777 权限（安全风险）"
-    suggestion: "使用更安全的权限设置，如 755 或 644"
-    operator_guidance: "按最小权限原则收紧权限；可执行文件通常使用 755，普通文件通常使用 644。"
-    doc_ref: "CLAUDE.md#基础安全规范"
-    tags: ["permissions", "security"]
-
-  - id: "no-drop-database"
-    when: |
-      tool == "Bash"
-      && args.command.lower().includes("drop database")
-    level: block
-    message: "禁止 DROP DATABASE 操作"
-    operator_guidance: "删库属于不可逆操作；先确认环境、库名和备份，再考虑使用更小粒度的数据变更命令。"
-    doc_ref: "CLAUDE.md#基础安全规范"
-    tags: ["database", "destructive"]
-
-  - id: "warn-drop-table"
-    when: |
-      tool == "Bash"
-      && args.command.lower().match(/drop\s+table/).ok()
-    level: warn
-    message: "检测到 DROP TABLE 操作，请确认不会误删生产数据"
-
-  - id: "warn-sensitive-file-write"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_path != null
-      && vars.sensitive_files.any(f => file_path.endsWith(f))
-    level: confirm
-    message: "正在修改敏感文件 {{file_path}}"
-    suggestion: "确认不会泄露密钥或凭证"
-
-  - id: "warn-hardcoded-secret"
-    when: |
-      tool.in(["Write", "Edit"])
-      && (args.content ?? args.new_string ?? "").match(/(?:password|api_key|secret|token)\s*[:=]\s*["'][^"']{8,}["']/).ok()
-    level: warn
-    message: "检测到疑似硬编码密钥，建议使用环境变量"
-
-escalation:
-  - id: "consecutive-failure-alert"
-    when: history.consecutive_failures >= 3
-    action: confirm
-    message: "已连续失败 {{history.consecutive_failures}} 次，是否需要调整方向？"
-    suggestion: "建议重新审视当前方法，或换一种思路"
-
-principles: |
-  ## 基础安全规范
-  - 受保护分支（main/master/production/staging）禁止强制推送
-  - 敏感文件（.env、credentials.json 等）修改需确认
-  - 禁止硬编码密钥，使用环境变量
-  - 连续失败 3 次将触发方向确认

package/dist/engine/conventions/code-quality.yaml

@@ -1,123 +0,0 @@
-id: "code-quality"
-name: "代码质量规范"
-version: "1.0.0"
-description: "通用代码质量规则，覆盖调试残留、危险函数和类型安全"
-
-variables:
-  max_console_log_per_file: 3
-  max_todo_per_file: 5
-  max_any_per_file: 5
-  production_file_patterns: [".ts", ".tsx", ".js", ".jsx"]
-  test_indicators: ["test", "spec", "__tests__", "__mocks__"]
-
-forbidden:
-  - id: "no-eval"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_ext.in(vars.production_file_patterns)
-      && (args.content ?? args.new_string ?? "").match(/\beval\s*\(/).ok()
-    level: block
-    message: "禁止使用 eval()，存在代码注入风险"
-    suggestion: "使用 JSON.parse()、Function 构造器或其他安全替代方案"
-
-  - id: "no-new-function"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_ext.in(vars.production_file_patterns)
-      && (args.content ?? args.new_string ?? "").match(/new\s+Function\s*\(/).ok()
-    level: warn
-    message: "检测到 new Function()，与 eval 类似存在安全风险"
-    suggestion: "考虑使用更安全的替代方案"
-
-  - id: "warn-console-log-production"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_ext.in(vars.production_file_patterns)
-      && !vars.test_indicators.any(t => file_path.includes(t))
-      && (args.content ?? args.new_string ?? "").split("console.log").length - 1 >= vars.max_console_log_per_file
-    level: warn
-    message: "生产代码中包含过多 console.log（>= {{vars.max_console_log_per_file}} 处）"
-    suggestion: "使用结构化日志库替代 console.log，或在提交前清理调试日志"
-
-  - id: "warn-console-debug"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_ext.in(vars.production_file_patterns)
-      && !vars.test_indicators.any(t => file_path.includes(t))
-      && (args.content ?? args.new_string ?? "").match(/console\.(debug|trace)\(/).ok()
-    level: warn
-    message: "生产代码中包含 console.debug/trace 调试语句"
-    suggestion: "提交前清理调试语句，或使用日志库的 debug 级别"
-
-  - id: "warn-todo-fixme-excess"
-    when: |
-      tool == "Write"
-      && file_ext.in(vars.production_file_patterns)
-      && (args.content ?? "").match(/(?:TODO|FIXME|HACK|XXX)/g).length >= vars.max_todo_per_file
-    level: warn
-    message: "文件中包含过多 TODO/FIXME 标记（>= {{vars.max_todo_per_file}} 处）"
-    suggestion: "将 TODO 转化为 Issue 跟踪，避免代码中积累过多待办"
-
-  - id: "warn-any-type-excess"
-    when: |
-      tool == "Write"
-      && file_ext == ".ts"
-      && !vars.test_indicators.any(t => file_path.includes(t))
-      && (args.content ?? "").match(/:\s*any\b/g).length >= vars.max_any_per_file
-    level: warn
-    message: "文件中包含过多 any 类型（>= {{vars.max_any_per_file}} 处）"
-    suggestion: "逐步替换为具体类型或 unknown，提升类型安全性"
-
-  - id: "no-ts-ignore"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_ext.in([".ts", ".tsx"])
-      && (args.content ?? args.new_string ?? "").match(/@ts-ignore/).ok()
-    level: warn
-    message: "检测到 @ts-ignore，会跳过类型检查"
-    suggestion: "使用 @ts-expect-error 并附带原因说明，或修复类型问题"
-
-  - id: "no-debugger"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_ext.in(vars.production_file_patterns)
-      && (args.content ?? args.new_string ?? "").match(/\bdebugger\b/).ok()
-    level: warn
-    message: "检测到 debugger 语句，提交前请移除"
-
-  - id: "warn-empty-catch"
-    when: |
-      tool.in(["Write", "Edit"])
-      && file_ext.in(vars.production_file_patterns)
-      && (args.content ?? args.new_string ?? "").match(/catch\s*\([^)]*\)\s*\{\s*\}/).ok()
-    level: warn
-    message: "检测到空 catch 块，异常被静默吞掉"
-    suggestion: "至少记录错误日志，或使用注释说明为何忽略"
-
-escalation:
-  - id: "quality-debt-accumulation"
-    when: |
-      history.file_changes.filter(f =>
-        f.endsWith(".ts") || f.endsWith(".tsx")
-      ).length >= 10
-      && history.file_changes.filter(f =>
-        f.includes("test") || f.includes("spec")
-      ).length == 0
-    action: warn
-    message: "已修改 10+ 个源文件但未编写任何测试"
-    suggestion: "建议为关键变更补充测试覆盖"
-
-deliverables:
-  - name: "ESLint 检查通过"
-    command: "npx eslint --max-warnings 0"
-    required: false
-    check_at: "before_commit"
-
-principles: |
-  ## 代码质量规范
-  - 禁止 eval() 和 new Function()
-  - 生产代码清理 console.log/debug/debugger
-  - 控制 TODO/FIXME 数量，及时转化为 Issue
-  - 限制 any 类型使用，优先使用具体类型
-  - 禁止空 catch 块，异常必须显式处理
-  - 大量源文件变更时提醒补充测试