@dommaker/harness 0.9.0 → 0.11.0

package/dist/extensions/long-running/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Long-Running Agents 扩展模块
+ *
+ * 来源：Anthropic Engineering Blog - Effective Harnesses for Long-Running Agents
+ * 参考：~/knowledge-base/projects/harness/anthropic-long-running-agents-roadmap.md
+ *
+ * 这个扩展模块提供：
+ * - 3 个特定约束（单功能推进、功能拆解、E2E 测试）
+ * - 类型定义（FeatureDefinition, ProjectProgress）
+ * - Puppeteer 测试相关类型
+ *
+ * 使用方式：
+ * 1. 选择 preset: 'long-running'
+ * 2. agent-runtime 导入并实现检查逻辑
+ * 3. agent-workflows 使用 initializer.yml 等工作流
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LONG_RUNNING_MODULE_INFO = exports.getLongRunningConstraint = exports.findLongRunningConstraintsByTrigger = exports.getAllLongRunningConstraints = exports.LONG_RUNNING_TIPS = exports.LONG_RUNNING_GUIDELINES = exports.LONG_RUNNING_IRON_LAWS = void 0;
+// 导出约束
+var constraints_1 = require("./constraints");
+Object.defineProperty(exports, "LONG_RUNNING_IRON_LAWS", { enumerable: true, get: function () { return constraints_1.LONG_RUNNING_IRON_LAWS; } });
+Object.defineProperty(exports, "LONG_RUNNING_GUIDELINES", { enumerable: true, get: function () { return constraints_1.LONG_RUNNING_GUIDELINES; } });
+Object.defineProperty(exports, "LONG_RUNNING_TIPS", { enumerable: true, get: function () { return constraints_1.LONG_RUNNING_TIPS; } });
+Object.defineProperty(exports, "getAllLongRunningConstraints", { enumerable: true, get: function () { return constraints_1.getAllLongRunningConstraints; } });
+Object.defineProperty(exports, "findLongRunningConstraintsByTrigger", { enumerable: true, get: function () { return constraints_1.findLongRunningConstraintsByTrigger; } });
+Object.defineProperty(exports, "getLongRunningConstraint", { enumerable: true, get: function () { return constraints_1.getLongRunningConstraint; } });
+// 导出模块信息
+exports.LONG_RUNNING_MODULE_INFO = {
+    name: 'long-running',
+    version: '0.7.0',
+    description: 'Anthropic Long-Running Agents 扩展',
+    constraints: {
+        ironLaws: 1,
+        guidelines: 2,
+        tips: 0,
+    },
+    types: [
+        'FeatureDefinition',
+        'FeatureList',
+        'ProjectProgress',
+        'FeatureStatus',
+        'SessionRecord',
+        'TestStep',
+        'StepResult',
+        'PuppeteerTestInput',
+        'PuppeteerTestResult',
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/extensions/long-running/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/long-running/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,OAAO;AACP,6CAOuB;AANrB,qHAAA,sBAAsB,OAAA;AACtB,sHAAA,uBAAuB,OAAA;AACvB,gHAAA,iBAAiB,OAAA;AACjB,2HAAA,4BAA4B,OAAA;AAC5B,kIAAA,mCAAmC,OAAA;AACnC,uHAAA,wBAAwB,OAAA;AAgB1B,SAAS;AACI,QAAA,wBAAwB,GAAG;IACtC,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,kCAAkC;IAC/C,WAAW,EAAE;QACX,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,CAAC;KACR;IACD,KAAK,EAAE;QACL,mBAAmB;QACnB,aAAa;QACb,iBAAiB;QACjB,eAAe;QACf,eAAe;QACf,UAAU;QACV,YAAY;QACZ,oBAAoB;QACpB,qBAAqB;KACtB;CACF,CAAC"}

package/dist/extensions/long-running/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Long-Running Agents 类型定义
+ *
+ * 来源：Anthropic Engineering Blog - Effective Harnesses for Long-Running Agents
+ * 参考：~/knowledge-base/projects/harness/anthropic-long-running-agents-roadmap.md
+ */
+/**
+ * 功能定义
+ *
+ * 用于 feature_list.json，记录项目级功能清单
+ */
+export interface FeatureDefinition {
+    /** 功能 ID */
+    id: string;
+    /** 功能分类 */
+    category: 'functional' | 'ui' | 'performance' | 'security';
+    /** 功能描述 */
+    description: string;
+    /** 测试步骤 */
+    steps: string[];
+    /** 是否通过 */
+    passes: boolean;
+    /** 优先级 */
+    priority: 'high' | 'medium' | 'low';
+    /** 依赖的其他功能 ID */
+    dependencies: string[];
+    /** 完成时间 */
+    completedAt?: string;
+    /** 完成的 session ID */
+    completedBy?: string;
+    /** 验证类型 */
+    verificationType: 'unit' | 'e2e' | 'manual';
+}
+/**
+ * 功能清单
+ */
+export interface FeatureList {
+    /** 项目 ID */
+    projectId: string;
+    /** 项目名称 */
+    projectName: string;
+    /** 功能列表 */
+    features: FeatureDefinition[];
+    /** 创建时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt: string;
+}
+/**
+ * 项目级进度
+ *
+ * 用于 claude-progress.json，跨 session 共享进度
+ */
+export interface ProjectProgress {
+    /** 项目 ID */
+    projectId: string;
+    /** 功能状态列表 */
+    features: FeatureStatus[];
+    /** Session 记录列表 */
+    sessions: SessionRecord[];
+    /** 最后更新时间 */
+    lastUpdate: string;
+}
+/**
+ * 功能状态
+ */
+export interface FeatureStatus {
+    /** 功能 ID */
+    featureId: string;
+    /** 状态 */
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+    /** 开始时间 */
+    startedAt?: string;
+    /** 完成时间 */
+    completedAt?: string;
+    /** 完成的 session 编号 */
+    completedBySession?: number;
+}
+/**
+ * Session 记录
+ */
+export interface SessionRecord {
+    /** Session 编号 */
+    sessionId: number;
+    /** 开始时间 */
+    startTime: string;
+    /** 结束时间 */
+    endTime: string;
+    /** 工作的功能 ID */
+    featureWorkedOn: string;
+    /** 结果 */
+    outcome: 'progress' | 'completed' | 'blocked' | 'failed';
+    /** 提交 hash 列表 */
+    commits: string[];
+    /** 进度说明 */
+    notes: string;
+}
+/**
+ * 测试步骤
+ *
+ * 用于 Puppeteer E2E 测试
+ */
+export interface TestStep {
+    /** 动作类型 */
+    action: 'navigate' | 'click' | 'type' | 'wait' | 'verify';
+    /** 步骤描述 */
+    description: string;
+    /** CSS 选择器 */
+    selector?: string;
+    /** URL */
+    url?: string;
+    /** 输入值 */
+    value?: string;
+    /** 期望值（用于 verify） */
+    expectedValue?: string;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+}
+/**
+ * 步骤结果
+ */
+export interface StepResult {
+    /** 是否通过 */
+    passed: boolean;
+    /** 步骤描述 */
+    description: string;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * Puppeteer 测试输入
+ */
+export interface PuppeteerTestInput {
+    /** 功能定义 */
+    feature: FeatureDefinition;
+    /** 测试基础 URL */
+    baseUrl: string;
+    /** 自定义测试步骤（可选） */
+    steps?: TestStep[];
+}
+/**
+ * Puppeteer 测试结果
+ */
+export interface PuppeteerTestResult {
+    /** 是否通过 */
+    passed: boolean;
+    /** 每个步骤的结果 */
+    results: StepResult[];
+    /** 失败的步骤 */
+    failedStep?: string;
+    /** 截图（base64） */
+    screenshot?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/long-running/types.d.ts.map

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

package/dist/extensions/long-running/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Long-Running Agents 类型定义
+ *
+ * 来源：Anthropic Engineering Blog - Effective Harnesses for Long-Running Agents
+ * 参考：~/knowledge-base/projects/harness/anthropic-long-running-agents-roadmap.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/extensions/long-running/types.js.map

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

package/dist/governance/executor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 治理执行器
+ *
+ * 检测差异 → 返回结果 → LLM 自行修复
+ * harness 只做检测，不做修复
+ */
+import type { GovernanceDiff, GovernanceResult } from './types';
+export declare class GovernanceExecutor {
+    /**
+     * 执行治理检查
+     *
+     * 检测差异并返回结果，不调用 hook，不执行修复
+     * LLM 拿到结果后自行决定如何处理
+     */
+    check(projectPath: string): Promise<GovernanceResult>;
+    /**
+     * 检测项目中的治理差异
+     */
+    detectDiffs(projectPath: string): Promise<GovernanceDiff[]>;
+    /**
+     * 检查 CAPABILITIES.md 与源码是否同步
+     */
+    private checkCapabilitiesSync;
+    /**
+     * 检查 CONTEXT.md 文件
+     */
+    private checkContextFiles;
+    /**
+     * 从治理配置获取需要 CONTEXT.md 的目录
+     */
+    private getRequiredContextDirs;
+    /**
+     * 解析 CAPABILITIES.md 中的文件路径
+     */
+    private parseCapabilitiesFiles;
+    /**
+     * 递归查找源文件
+     */
+    private findSourceFiles;
+}
+/**
+ * 全局治理执行器单例
+ */
+export declare const governanceExecutor: GovernanceExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/governance/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/governance/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,qBAAa,kBAAkB;IAC7B;;;;;OAKG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS3D;;OAEG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAcjE;;OAEG;YACW,qBAAqB;IA4DnC;;OAEG;YACW,iBAAiB;IA2C/B;;OAEG;YACW,sBAAsB;IAgBpC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;YACW,eAAe;CAyB9B;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/governance/executor.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * 治理执行器
+ *
+ * 检测差异 → 返回结果 → LLM 自行修复
+ * harness 只做检测，不做修复
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.governanceExecutor = exports.GovernanceExecutor = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+class GovernanceExecutor {
+    /**
+     * 执行治理检查
+     *
+     * 检测差异并返回结果，不调用 hook，不执行修复
+     * LLM 拿到结果后自行决定如何处理
+     */
+    async check(projectPath) {
+        const diffs = await this.detectDiffs(projectPath);
+        return {
+            hasDiffs: diffs.length > 0,
+            diffs,
+        };
+    }
+    /**
+     * 检测项目中的治理差异
+     */
+    async detectDiffs(projectPath) {
+        const diffs = [];
+        // 1. 检查 CAPABILITIES.md 与源码的差异
+        const capDiffs = await this.checkCapabilitiesSync(projectPath);
+        diffs.push(...capDiffs);
+        // 2. 检查 CONTEXT.md
+        const contextDiffs = await this.checkContextFiles(projectPath);
+        diffs.push(...contextDiffs);
+        return diffs;
+    }
+    /**
+     * 检查 CAPABILITIES.md 与源码是否同步
+     */
+    async checkCapabilitiesSync(projectPath) {
+        const diffs = [];
+        const capabilitiesPath = path.join(projectPath, 'CAPABILITIES.md');
+        // 读取 CAPABILITIES.md
+        let capContent;
+        try {
+            capContent = await fs.readFile(capabilitiesPath, 'utf-8');
+        }
+        catch {
+            // CAPABILITIES.md 不存在
+            return [];
+        }
+        // 解析表格中的文件路径
+        const listedFiles = this.parseCapabilitiesFiles(capContent);
+        // 如果没有表格，跳过
+        if (listedFiles.length === 0)
+            return [];
+        // 扫描 src/ 中的实际文件
+        const srcDir = path.join(projectPath, 'src');
+        const actualFiles = await this.findSourceFiles(srcDir, projectPath);
+        // 找出新增但未列出的文件
+        const missing = actualFiles.filter(f => !listedFiles.includes(f));
+        // 找出已列出但已删除的文件
+        const removed = listedFiles.filter(f => !actualFiles.includes(f));
+        if (missing.length > 0) {
+            diffs.push({
+                type: 'doc_mismatch',
+                projectPath,
+                details: {
+                    file: capabilitiesPath,
+                    current: capContent,
+                    expected: `新增文件未在 CAPABILITIES.md 中列出: ${missing.join(', ')}`,
+                    files: missing,
+                    context: { missing, listedFiles, actualFiles },
+                },
+            });
+        }
+        if (removed.length > 0) {
+            diffs.push({
+                type: 'doc_mismatch',
+                projectPath,
+                details: {
+                    file: capabilitiesPath,
+                    current: capContent,
+                    expected: `CAPABILITIES.md 中列出的文件已不存在: ${removed.join(', ')}`,
+                    files: removed,
+                    context: { removed, listedFiles, actualFiles },
+                },
+            });
+        }
+        return diffs;
+    }
+    /**
+     * 检查 CONTEXT.md 文件
+     */
+    async checkContextFiles(projectPath) {
+        const diffs = [];
+        const requiredDirs = await this.getRequiredContextDirs(projectPath);
+        for (const dir of requiredDirs) {
+            const contextPath = path.join(projectPath, dir, 'CONTEXT.md');
+            try {
+                const content = await fs.readFile(contextPath, 'utf-8');
+                // 检查内容是否只是模板（没有实际填写）
+                const isTemplate = content.includes('<!-- 本目录')
+                    || content.includes('<!-- 此文件描述');
+                if (isTemplate) {
+                    diffs.push({
+                        type: 'context_outdated',
+                        projectPath,
+                        details: {
+                            file: contextPath,
+                            current: content,
+                            moduleName: dir,
+                            context: { reason: 'CONTEXT.md 仍为模板，未填写实际内容' },
+                        },
+                    });
+                }
+            }
+            catch {
+                // CONTEXT.md 不存在
+                diffs.push({
+                    type: 'context_missing',
+                    projectPath,
+                    details: {
+                        file: contextPath,
+                        moduleName: dir,
+                        context: { requiredDir: dir },
+                    },
+                });
+            }
+        }
+        return diffs;
+    }
+    /**
+     * 从治理配置获取需要 CONTEXT.md 的目录
+     */
+    async getRequiredContextDirs(projectPath) {
+        const configPath = path.join(projectPath, '.harness', 'config.yml');
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            const config = yaml.load(content);
+            const governance = config.governance;
+            const contextFiles = governance?.context_files;
+            if (contextFiles?.enabled && Array.isArray(contextFiles.required_dirs)) {
+                return contextFiles.required_dirs;
+            }
+        }
+        catch {
+            // 配置不存在
+        }
+        return [];
+    }
+    /**
+     * 解析 CAPABILITIES.md 中的文件路径
+     */
+    parseCapabilitiesFiles(content) {
+        const files = [];
+        const tableRowRegex = /^\|[^|]+\|\s*([^|]+?\.(?:ts|tsx|js|jsx))\s*\|/gm;
+        let match;
+        while ((match = tableRowRegex.exec(content)) !== null) {
+            files.push(match[1].trim());
+        }
+        return files;
+    }
+    /**
+     * 递归查找源文件
+     */
+    async findSourceFiles(dir, projectPath) {
+        const results = [];
+        let entries;
+        try {
+            entries = await fs.readdir(dir);
+        }
+        catch {
+            return [];
+        }
+        for (const entry of entries) {
+            if (entry === 'node_modules' || entry === '__tests__' || entry === 'dist')
+                continue;
+            const entryPath = path.join(dir, entry);
+            try {
+                const stat = await fs.stat(entryPath);
+                if (stat.isDirectory()) {
+                    results.push(...await this.findSourceFiles(entryPath, projectPath));
+                }
+                else if (entry.endsWith('.ts') && !entry.endsWith('.d.ts')) {
+                    results.push(path.relative(projectPath, entryPath));
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        return results;
+    }
+}
+exports.GovernanceExecutor = GovernanceExecutor;
+/**
+ * 全局治理执行器单例
+ */
+exports.governanceExecutor = new GovernanceExecutor();
+//# sourceMappingURL=executor.js.map

package/dist/governance/executor.js.map

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

package/dist/governance/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 治理模块
+ *
+ * harness 检测差异，LLM 自行修复
+ * 只提供检测能力，不提供修复机制
+ */
+export { GovernanceExecutor, governanceExecutor } from './executor';
+export type { DiffType, GovernanceDiff, GovernanceResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACpE,YAAY,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/governance/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * 治理模块
+ *
+ * harness 检测差异，LLM 自行修复
+ * 只提供检测能力，不提供修复机制
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.governanceExecutor = exports.GovernanceExecutor = void 0;
+var executor_1 = require("./executor");
+Object.defineProperty(exports, "GovernanceExecutor", { enumerable: true, get: function () { return executor_1.GovernanceExecutor; } });
+Object.defineProperty(exports, "governanceExecutor", { enumerable: true, get: function () { return executor_1.governanceExecutor; } });
+//# sourceMappingURL=index.js.map

package/dist/governance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uCAAoE;AAA3D,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA"}

package/dist/governance/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 治理类型定义
+ *
+ * harness 检测差异，LLM 自行决定如何修复
+ * 不需要 hook 返回内容、不需要 apply 机制
+ */
+/**
+ * 差异类型
+ */
+export type DiffType = 'doc_mismatch' | 'context_missing' | 'context_outdated' | 'test_gap' | 'constraint_violation' | 'changelog_missing';
+/**
+ * 治理检查结果（harness 检测到的差异）
+ */
+export interface GovernanceDiff {
+    /** 差异类型 */
+    type: DiffType;
+    /** 项目路径 */
+    projectPath: string;
+    /** 差异详情 */
+    details: {
+        /** 目标文件 */
+        file?: string;
+        /** 现有内容 */
+        current?: string;
+        /** 期望内容（代码实际情况） */
+        expected?: string;
+        /** 相关文件列表 */
+        files?: string[];
+        /** 模块名 */
+        moduleName?: string;
+        /** 约束 ID */
+        constraintId?: string;
+        /** 额外上下文 */
+        context?: Record<string, unknown>;
+    };
+}
+/**
+ * 治理执行结果
+ */
+export interface GovernanceResult {
+    /** 是否有差异 */
+    hasDiffs: boolean;
+    /** 检测到的差异 */
+    diffs: GovernanceDiff[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,sBAAsB,GACtB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,OAAO,EAAE;QACP,WAAW;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW;QACX,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mBAAmB;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa;QACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU;QACV,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

package/dist/governance/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * 治理类型定义
+ *
+ * harness 检测差异，LLM 自行决定如何修复
+ * 不需要 hook 返回内容、不需要 apply 机制
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/governance/types.js.map

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