@dommaker/harness 0.8.3 → 0.10.0

package/dist/context/tool-output-budget.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * 工具输出预算
+ *
+ * 控制工具输出对上下文的占用
+ * 策略：full / preview / overflow / dedup
+ */
+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.ToolOutputBudget = void 0;
+const crypto = __importStar(require("crypto"));
+const token_budget_1 = require("./token-budget");
+const types_1 = require("./types");
+class ToolOutputBudget {
+    config;
+    seenHashes = new Map();
+    constructor(config) {
+        this.config = { ...types_1.DEFAULT_TOOL_OUTPUT_BUDGET, ...config };
+    }
+    /**
+     * 检查工具输出应该使用什么策略
+     */
+    checkOutput(output, totalBudget) {
+        const charCount = output.length;
+        const tokens = token_budget_1.TokenEstimator.estimateText(output);
+        // 去重检查
+        if (this.config.dedup) {
+            const hash = this.computeHash(output);
+            if (this.seenHashes.has(hash)) {
+                return { allowed: true, strategy: 'dedup', reason: '重复内容，将被去重' };
+            }
+            // 记录 hash（无论最终策略是什么）
+            this.seenHashes.set(hash, true);
+        }
+        // 硬上限检查
+        if (charCount > this.config.maxChars) {
+            return {
+                allowed: true,
+                strategy: this.config.overflowToDisk ? 'overflow' : 'preview',
+                reason: `输出 ${charCount} 字符超过限制 ${this.config.maxChars}`,
+            };
+        }
+        // Token 比例检查
+        if (totalBudget) {
+            const maxTokens = totalBudget * this.config.maxTokenRatio;
+            if (tokens > maxTokens) {
+                return {
+                    allowed: true,
+                    strategy: 'preview',
+                    reason: `输出 ${tokens} tokens 超过预算比例 ${(this.config.maxTokenRatio * 100).toFixed(0)}% (${Math.floor(maxTokens)} tokens)`,
+                };
+            }
+        }
+        return { allowed: true, strategy: 'full' };
+    }
+    /**
+     * 应用预算策略
+     */
+    applyBudget(output, strategy, totalBudget) {
+        const originalTokens = token_budget_1.TokenEstimator.estimateText(output);
+        switch (strategy) {
+            case 'full': {
+                if (this.config.dedup) {
+                    this.recordHash(output);
+                }
+                return { content: output, originalTokens, keptTokens: originalTokens };
+            }
+            case 'preview': {
+                const preview = this.generatePreview(output);
+                const keptTokens = token_budget_1.TokenEstimator.estimateText(preview);
+                return { content: preview, originalTokens, keptTokens };
+            }
+            case 'overflow': {
+                const path = this.writeToOverflow(output);
+                const summary = `[输出已写入磁盘: ${path}]\n前 ${this.config.previewLines} 行预览:\n${output.split('\n').slice(0, this.config.previewLines).join('\n')}`;
+                const keptTokens = token_budget_1.TokenEstimator.estimateText(summary);
+                return { content: summary, offloaded: { path }, originalTokens, keptTokens };
+            }
+            case 'dedup': {
+                const dedupContent = `[重复内容，已省略。原始大小: ${output.length} 字符]`;
+                return { content: dedupContent, originalTokens, keptTokens: token_budget_1.TokenEstimator.estimateText(dedupContent) };
+            }
+            default:
+                return { content: output, originalTokens, keptTokens: originalTokens };
+        }
+    }
+    /**
+     * 生成预览内容
+     */
+    generatePreview(output) {
+        const lines = output.split('\n');
+        const previewLines = this.config.previewLines;
+        if (lines.length <= previewLines) {
+            return output;
+        }
+        const head = lines.slice(0, previewLines).join('\n');
+        const omitted = lines.length - previewLines;
+        return `${head}\n\n... [省略 ${omitted} 行] ...\n\n${lines.slice(-3).join('\n')}`;
+    }
+    /**
+     * 写入溢出文件
+     */
+    writeToOverflow(output) {
+        const hash = this.computeHash(output).slice(0, 8);
+        const path = `.harness/overflow/tool-output-${hash}.txt`;
+        try {
+            const fs = require('fs');
+            const dir = require('path').dirname(path);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(path, output, 'utf-8');
+        }
+        catch {
+            // 写入失败时回退到 preview
+            return '';
+        }
+        return path;
+    }
+    /**
+     * 计算内容 hash
+     */
+    computeHash(content) {
+        return crypto.createHash('md5').update(content).digest('hex');
+    }
+    /**
+     * 记录已见 hash
+     */
+    recordHash(content) {
+        const hash = this.computeHash(content);
+        this.seenHashes.set(hash, true);
+    }
+    /**
+     * 清除去重缓存
+     */
+    clearDedupCache() {
+        this.seenHashes.clear();
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.ToolOutputBudget = ToolOutputBudget;
+//# sourceMappingURL=tool-output-budget.js.map

package/dist/context/tool-output-budget.js.map

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

package/dist/context/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 上下文管理类型定义
+ *
+ * Phase 2: Token 流水线 + 预算 + 压缩
+ */
+import type { QueryResult } from '../knowledge/types';
+export interface FileBudgetConfig {
+    maxLines: number;
+    maxBytes: number;
+    maxTokenEstimate: number;
+    continuationHint: boolean;
+}
+export declare const DEFAULT_FILE_BUDGET: FileBudgetConfig;
+export interface ToolOutputBudgetConfig {
+    maxChars: number;
+    maxTokenRatio: number;
+    previewLines: number;
+    overflowToDisk: boolean;
+    dedup: boolean;
+}
+export declare const DEFAULT_TOOL_OUTPUT_BUDGET: ToolOutputBudgetConfig;
+export type CompactionLevel = 'eviction' | 'summary' | 'checkpoint';
+export interface CompactionConfig {
+    triggerRatio: number;
+    level: CompactionLevel;
+    preserveToolCallPairs: boolean;
+    structuredSummary: boolean;
+    maxSummaryTokens: number;
+    fallbackStrategy: 'truncate-middle' | 'head-drop' | 'retry-with-clamp';
+}
+export declare const DEFAULT_COMPACTION_CONFIG: CompactionConfig;
+export interface SessionMessage {
+    role: 'user' | 'assistant' | 'tool';
+    content: string;
+    toolCallId?: string;
+    timestamp: string;
+}
+export type ContextSourceType = 'session_event' | 'tool_output' | 'knowledge' | 'user_message' | 'system_prompt' | 'tool_definition';
+export interface ContextSource {
+    type: ContextSourceType;
+    id: string;
+    content: string;
+    priority: number;
+    metadata?: Record<string, any>;
+}
+export interface TokenBudgetAllocation {
+    total: number;
+    systemPrompt: number;
+    toolDefinitions: number;
+    knowledge: number;
+    notes: number;
+    history: number;
+}
+export interface PipelineInput {
+    sources: ContextSource[];
+    budget: TokenBudgetAllocation;
+    knowledge?: QueryResult;
+}
+export interface PipelineOutput {
+    prompt: string;
+    snapshot: ContextUsageSnapshot;
+    dropped: Array<{
+        type: string;
+        id: string;
+        reason: string;
+    }>;
+}
+export interface ContextUsageSnapshot {
+    timestamp: string;
+    totalTokens: number;
+    breakdown: {
+        systemPrompt: number;
+        messages: number;
+        toolOutputs: number;
+        knowledge: number;
+        other: number;
+    };
+    truncatedItems: Array<{
+        type: string;
+        id: string;
+        originalTokens: number;
+        keptTokens: number;
+    }>;
+    offloadedItems: Array<{
+        type: string;
+        id: string;
+        target: 'disk' | 'summary' | 'dropped';
+    }>;
+    compactionTriggered: boolean;
+    compactionLevel?: CompactionLevel;
+}
+export type SessionEventType = 'user_message' | 'assistant_message' | 'tool_call' | 'tool_result' | 'checkpoint' | 'system';
+export interface SessionEvent {
+    type: SessionEventType;
+    id: string;
+    content: string;
+    timestamp: string;
+    metadata?: Record<string, any>;
+}
+export interface SessionHandle {
+    id: string;
+    events: SessionEvent[];
+    createdAt: string;
+    lastActiveAt: string;
+}
+export interface SessionCheckpoint {
+    id: string;
+    sessionId: string;
+    timestamp: string;
+    eventCount: number;
+    summary: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/context/types.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * 上下文管理类型定义
+ *
+ * Phase 2: Token 流水线 + 预算 + 压缩
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COMPACTION_CONFIG = exports.DEFAULT_TOOL_OUTPUT_BUDGET = exports.DEFAULT_FILE_BUDGET = void 0;
+exports.DEFAULT_FILE_BUDGET = {
+    maxLines: 2000,
+    maxBytes: 51200,
+    maxTokenEstimate: 8000,
+    continuationHint: true,
+};
+exports.DEFAULT_TOOL_OUTPUT_BUDGET = {
+    maxChars: 16000,
+    maxTokenRatio: 0.3,
+    previewLines: 50,
+    overflowToDisk: false,
+    dedup: true,
+};
+exports.DEFAULT_COMPACTION_CONFIG = {
+    triggerRatio: 0.8,
+    level: 'eviction',
+    preserveToolCallPairs: true,
+    structuredSummary: true,
+    maxSummaryTokens: 2000,
+    fallbackStrategy: 'truncate-middle',
+};
+//# sourceMappingURL=types.js.map

package/dist/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAeU,QAAA,mBAAmB,GAAqB;IACnD,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,KAAK;IACf,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAcW,QAAA,0BAA0B,GAA2B;IAChE,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,KAAK;IACrB,KAAK,EAAE,IAAI;CACZ,CAAC;AAiBW,QAAA,yBAAyB,GAAqB;IACzD,YAAY,EAAE,GAAG;IACjB,KAAK,EAAE,UAAU;IACjB,qBAAqB,EAAE,IAAI;IAC3B,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,iBAAiB;CACpC,CAAC"}

package/dist/core/constraints/checker.d.ts

@@ -6,7 +6,7 @@
  * - Guidelines：检查失败记录警告
  * - Tips：检查失败记录提示
  */
-import type { Constraint, ConstraintContext, ConstraintResult, ConstraintCheckResult } from '../../types/constraint';
+import { Constraint, ConstraintContext, ConstraintResult, ConstraintCheckResult } from '../../types/constraint';
 import type { MergedConstraintsConfig } from '../../types/project-config';
 /**
  * 约束检查器
@@ -44,6 +44,14 @@ export declare class ConstraintChecker {
      * 根据约束层级获取严重性
      */
     private getSeverity;
+    /**
+     * 判断约束是否匹配当前触发条件
+     */
+    private matchesTrigger;
+    /**
+     * 记录约束检查的 trace
+     */
+    private recordTrace;
     /**
      * 检查约束前置条件
      */
@@ -64,6 +72,10 @@ export declare class ConstraintChecker {
      * 检查 capability_sync：检查 CAPABILITIES.md 是否更新
      */
     private checkCapabilitySync;
+    /**
+     * 解析 CAPABILITIES.md 中表格的文件路径列
+     */
+    private parseCapabilitiesFiles;
     /**
      * 检查 no_simplification_without_approval：检查简化关键词
      */
@@ -72,6 +84,18 @@ export declare class ConstraintChecker {
      * 检查 test_coverage_required：读取 coverage 报告
      */
     private checkTestCoverage;
+    /**
+     * 检查 context_doc_sync：关键目录是否有 CONTEXT.md
+     */
+    private checkContextDocSync;
+    /**
+     * 检查 docs_freshness：CAPABILITIES.md 是否与源码同步
+     */
+    private checkDocsFreshness;
+    /**
+     * 查找 src/ 目录中的源文件
+     */
+    private findSourceFiles;
     /**
      * 查找适用于当前操作的约束
      */

package/dist/core/constraints/checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../../src/core/constraints/checker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EAGtB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAK1E;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C,mBAAmB;IACnB,OAAO,CAAC,YAAY,CAAwC;IAE5D,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAItD;;OAEG;IACH,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KAClC;IAeD;;OAEG;IACG,KAAK,CACT,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC;IA6B5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAkFtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;YACW,iBAAiB;IAmF/B;;OAEG;YACW,uBAAuB;IAiCrC;;OAEG;YACW,yBAAyB;IAwBvC;;OAEG;YACW,cAAc;IAmC5B;;OAEG;YACW,mBAAmB;IA2BjC;;OAEG;YACW,oCAAoC;IAwBlD;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;IACH,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG;QACrD,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,UAAU,EAAE,UAAU,EAAE,CAAC;QACzB,IAAI,EAAE,UAAU,EAAE,CAAC;KACpB;IAoBD;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2GlF;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBjE;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF;AAGD,eAAO,MAAM,iBAAiB,mBAAkC,CAAC;AAMjE;;GAEG;AACH,eAAO,MAAM,cAAc,0BAAoB,CAAC;AAEhD;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG7B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,mBAAoB,CAAC"}
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../../src/core/constraints/checker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EAItB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAqC1E;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C,mBAAmB;IACnB,OAAO,CAAC,YAAY,CAAwC;IAE5D,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAOvC;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAItD;;OAEG;IACH,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KAClC;IAeD;;OAEG;IACG,KAAK,CACT,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC;IA6B5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;YACW,iBAAiB;IAkG/B;;OAEG;YACW,uBAAuB;IAiCrC;;OAEG;YACW,yBAAyB;IAwBvC;;OAEG;YACW,cAAc;IAmC5B;;OAEG;YACW,mBAAmB;IA8CjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;OAEG;YACW,oCAAoC;IAwBlD;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;YACW,mBAAmB;IA0BjC;;OAEG;YACW,kBAAkB;IAmChC;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG;QACrD,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,UAAU,EAAE,UAAU,EAAE,CAAC;QACzB,IAAI,EAAE,UAAU,EAAE,CAAC;KACpB;IAoBD;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwDlF;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAajE;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF;AAGD,eAAO,MAAM,iBAAiB,mBAAkC,CAAC;AAMjE;;GAEG;AACH,eAAO,MAAM,cAAc,0BAAoB,CAAC;AAEhD;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG7B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,mBAAoB,CAAC"}