@dommaker/harness 1.1.1 → 1.2.1

package/dist/index.js

@@ -15,162 +15,199 @@
  * - PerformanceGate：性能门禁
  * - ContractGate：契约门禁
  * - CheckpointValidator：检查点验证
+ *
+ * 公共导出（ADR-0003）：显式清单，禁 export *。
+ * 收录标准：属 harness 定位（约束数据 / 执行引擎 / 注入工具 / 知识基建）、
+ * 实现真实可用、无同名冲突。内部 seam
+ * （ConstraintChecker / constraintChecker / ProjectConfigLoader）不进公共清单。
  */
-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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.interceptor = exports.renderConstraintsByTrigger = exports.CheckCache = void 0;
-exports.interceptOperation = interceptOperation;
-exports.claimOperation = claimOperation;
-exports.registerExecutor = registerExecutor;
-exports.checkConstraints = checkConstraints;
-exports.checkBeforeExecution = checkBeforeExecution;
-// ========================================
-// 类型导出
-// ========================================
-__exportStar(require("./types"), exports);
-// ========================================
-// 核心功能导出
-// ========================================
-__exportStar(require("./core"), exports);
-// ========================================
-// 门禁系统导出
-// ========================================
-__exportStar(require("./gates"), exports);
-// ========================================
-// 监控导出
-// ========================================
-__exportStar(require("./monitoring"), exports);
-// ========================================
-// 失败处理导出
-// ========================================
-__exportStar(require("./failure"), exports);
-// ========================================
-// Spec 检查导出
-// ========================================
-__exportStar(require("./spec/annotation-checker"), exports);
-// ========================================
-// 上下文管理导出
-// ========================================
-__exportStar(require("./context"), exports);
-// ========================================
-// 知识引擎导出
-// ========================================
-__exportStar(require("./knowledge"), exports);
-// ========================================
-// 安全护栏导出
-// ========================================
-__exportStar(require("./safety"), exports);
-// ========================================
-// 验证循环导出
-// ========================================
-__exportStar(require("./verification"), exports);
-// ========================================
-// Completion Checkers 导出（T7-E1，studio#160）
-// WU 收尾软观测三纯判定函数：tdd-chain / phase-format / contract-presence。
-// 纯函数直接 export，不进 ConstraintCheck 闭环注册表。
-// ========================================
-__exportStar(require("./completion-checkers"), exports);
-// ========================================
-// Dashboard 数据导出
-// ========================================
-__exportStar(require("./dashboard"), exports);
-// ========================================
-// 工具路径导出
+exports.listRegisteredGates = exports.getGate = exports.GATE_DEFINITIONS = exports.decisionFromResult = exports.createSpecAcceptanceGate = exports.createContractGate = exports.createPerformanceGate = exports.createSecurityGate = exports.createReviewGate = exports.DEFAULT_COMMAND_BLACKLIST = exports.getCommandRiskLevel = exports.isCommandAllowed = exports.getCommandGate = exports.createCommandGate = exports.CommandGate = exports.SpecAcceptanceGate = exports.ContractGate = exports.PerformanceGate = exports.SecurityGate = exports.ReviewGate = exports.validateAllSpecs = exports.validateSpec = exports.SpecValidator = exports.createCleanStateManager = exports.CleanStateManager = exports.MINIMAL_CHECKPOINTS = exports.DEFAULT_CODE_CHECKPOINTS = exports.createSessionStartup = exports.SessionStartup = exports.CSOValidator = exports.createPassesGate = exports.PassesGate = exports.CheckpointValidator = exports.renderConstraintsSection = exports.CONSTRAINTS_END_MARKER = exports.CONSTRAINTS_START_MARKER = exports.renderConstraintsByTrigger = exports.CheckCache = exports.checkBeforeExecution = exports.checkConstraints = exports.checkConstraint = exports.lintEffectiveConfig = exports.getEffectiveConstraints = exports.findConstraintsByTrigger = exports.getConstraint = exports.getAllConstraints = exports.PROMPTS = exports.GUIDELINES = exports.IRON_LAWS = exports.ConstraintViolationError = void 0;
+exports.matchGlob = exports.DEFAULT_NONCODE_GLOBS = exports.DEFAULT_TEST_GLOBS = exports.DEFAULT_DECAY_CONFIG = exports.extractCodeStructure = exports.migrateKnowledgeEntries = exports.KnowledgeAudit = exports.KnowledgeLifecycleHooks = exports.KnowledgeHealthScorer = exports.ColdStartImporter = exports.KnowledgeLinter = exports.ReferenceTracker = exports.sanitizeExternalContent = exports.KnowledgeIngest = exports.KnowledgeLifecycle = exports.KnowledgeQuery = exports.FileKnowledgeStore = exports.KnowledgeInjector = exports.SessionManager = exports.SessionCompaction = exports.DEFAULT_COMPACTION_CONFIG = exports.TokenEstimator = exports.TokenBudget = exports.AdaptiveTokenBudget = exports.executeWithSafeBoolean = exports.executeWithCollect = exports.executeWithBlock = exports.ConstraintViolationHandler = exports.createFailureRecorder = exports.FailureRecorder = exports.getFailureLevel = exports.classifyError = exports.createErrorClassifier = exports.ErrorClassifier = exports.DEFAULT_LEVEL_MAPPING = exports.DEFAULT_CLASSIFICATION_RULES = exports.FailureLevel = exports.ErrorType = exports.ContextTracker = exports.createAnalyzer = exports.TraceAnalyzer = exports.configureTraceCollector = exports.getTraceCollector = exports.TraceCollector = exports.DEFAULT_TRACE_FILE = exports.createCheckerGate = exports.getEffectiveGates = exports.runGates = exports.assertGateRegistryClosed = exports.registeredGateCount = void 0;
+exports.AgentLifecycle = exports.bootstrapHarnessSync = exports.bootstrapHarness = exports.toErrorStrategy = exports.HookPipeline = exports.assertHookRegistryClosed = exports.HookRegistry = exports.getToolsDir = exports.getRegistryPath = exports.verifyContractPresence = exports.PHASE_SUBJECT_RE = exports.verifyPhaseFormat = exports.TESTS_NONE_RE = exports.TESTED_BY_RE = exports.verifyTddChain = exports.resolveGlobs = exports.classifyCommitFiles = exports.matchAnyGlob = void 0;
 // ========================================
-__exportStar(require("./tools"), exports);
+// 约束类型（三层体系 + kind 二元）
 // ========================================
-// Hooks 管线导出（Phase 1）
+var constraint_1 = require("./types/constraint");
+Object.defineProperty(exports, "ConstraintViolationError", { enumerable: true, get: function () { return constraint_1.ConstraintViolationError; } });
 // ========================================
-__exportStar(require("./hooks"), exports);
+// 约束数据（内置定义 + 生效集）
 // ========================================
-// Agent 生命周期导出
+var definitions_1 = require("./core/constraints/definitions");
+Object.defineProperty(exports, "IRON_LAWS", { enumerable: true, get: function () { return definitions_1.IRON_LAWS; } });
+Object.defineProperty(exports, "GUIDELINES", { enumerable: true, get: function () { return definitions_1.GUIDELINES; } });
+Object.defineProperty(exports, "PROMPTS", { enumerable: true, get: function () { return definitions_1.PROMPTS; } });
+Object.defineProperty(exports, "getAllConstraints", { enumerable: true, get: function () { return definitions_1.getAllConstraints; } });
+Object.defineProperty(exports, "getConstraint", { enumerable: true, get: function () { return definitions_1.getConstraint; } });
+Object.defineProperty(exports, "findConstraintsByTrigger", { enumerable: true, get: function () { return definitions_1.findConstraintsByTrigger; } });
+var effective_constraints_1 = require("./core/effective-constraints");
+Object.defineProperty(exports, "getEffectiveConstraints", { enumerable: true, get: function () { return effective_constraints_1.getEffectiveConstraints; } });
+Object.defineProperty(exports, "lintEffectiveConfig", { enumerable: true, get: function () { return effective_constraints_1.lintEffectiveConfig; } });
 // ========================================
-__exportStar(require("./agents"), exports);
+// 约束检查引擎（便捷 API；options 统一签名，ADR-0003）
 // ========================================
-// 预设导出
+var checker_1 = require("./core/constraints/checker");
+Object.defineProperty(exports, "checkConstraint", { enumerable: true, get: function () { return checker_1.checkConstraint; } });
+Object.defineProperty(exports, "checkConstraints", { enumerable: true, get: function () { return checker_1.checkConstraints; } });
+Object.defineProperty(exports, "checkBeforeExecution", { enumerable: true, get: function () { return checker_1.checkBeforeExecution; } });
 // ========================================
-__exportStar(require("./presets"), exports);
-// ========================================
-// 约束缓存与渲染导出（H6/G5-G6，#31 收编）
+// 约束缓存与注入渲染
 // ========================================
 var check_cache_1 = require("./core/constraints/check-cache");
 Object.defineProperty(exports, "CheckCache", { enumerable: true, get: function () { return check_cache_1.CheckCache; } });
 var agent_prompt_renderer_1 = require("./core/constraints/agent-prompt-renderer");
 Object.defineProperty(exports, "renderConstraintsByTrigger", { enumerable: true, get: function () { return agent_prompt_renderer_1.renderConstraintsByTrigger; } });
+var injection_renderer_1 = require("./core/constraints/injection-renderer");
+Object.defineProperty(exports, "CONSTRAINTS_START_MARKER", { enumerable: true, get: function () { return injection_renderer_1.CONSTRAINTS_START_MARKER; } });
+Object.defineProperty(exports, "CONSTRAINTS_END_MARKER", { enumerable: true, get: function () { return injection_renderer_1.CONSTRAINTS_END_MARKER; } });
+Object.defineProperty(exports, "renderConstraintsSection", { enumerable: true, get: function () { return injection_renderer_1.renderConstraintsSection; } });
+var validators_1 = require("./core/validators");
+Object.defineProperty(exports, "CheckpointValidator", { enumerable: true, get: function () { return validators_1.CheckpointValidator; } });
+Object.defineProperty(exports, "PassesGate", { enumerable: true, get: function () { return validators_1.PassesGate; } });
+Object.defineProperty(exports, "createPassesGate", { enumerable: true, get: function () { return validators_1.createPassesGate; } });
+Object.defineProperty(exports, "CSOValidator", { enumerable: true, get: function () { return validators_1.CSOValidator; } });
+// ========================================
+// 会话启动 / 净室状态
+// ========================================
+var session_1 = require("./core/session");
+Object.defineProperty(exports, "SessionStartup", { enumerable: true, get: function () { return session_1.SessionStartup; } });
+Object.defineProperty(exports, "createSessionStartup", { enumerable: true, get: function () { return session_1.createSessionStartup; } });
+Object.defineProperty(exports, "DEFAULT_CODE_CHECKPOINTS", { enumerable: true, get: function () { return session_1.DEFAULT_CODE_CHECKPOINTS; } });
+Object.defineProperty(exports, "MINIMAL_CHECKPOINTS", { enumerable: true, get: function () { return session_1.MINIMAL_CHECKPOINTS; } });
+Object.defineProperty(exports, "CleanStateManager", { enumerable: true, get: function () { return session_1.CleanStateManager; } });
+Object.defineProperty(exports, "createCleanStateManager", { enumerable: true, get: function () { return session_1.createCleanStateManager; } });
+// ========================================
+// Spec 验证（已接线的 spec 故事：validator + SpecAcceptanceGate）
+// ========================================
+var validator_1 = require("./core/spec/validator");
+Object.defineProperty(exports, "SpecValidator", { enumerable: true, get: function () { return validator_1.SpecValidator; } });
+Object.defineProperty(exports, "validateSpec", { enumerable: true, get: function () { return validator_1.validateSpec; } });
+Object.defineProperty(exports, "validateAllSpecs", { enumerable: true, get: function () { return validator_1.validateAllSpecs; } });
+// ========================================
+// 门禁系统（公共面 = ./gates 子路径出口）
+// ========================================
+var gates_1 = require("./gates");
+Object.defineProperty(exports, "ReviewGate", { enumerable: true, get: function () { return gates_1.ReviewGate; } });
+Object.defineProperty(exports, "SecurityGate", { enumerable: true, get: function () { return gates_1.SecurityGate; } });
+Object.defineProperty(exports, "PerformanceGate", { enumerable: true, get: function () { return gates_1.PerformanceGate; } });
+Object.defineProperty(exports, "ContractGate", { enumerable: true, get: function () { return gates_1.ContractGate; } });
+Object.defineProperty(exports, "SpecAcceptanceGate", { enumerable: true, get: function () { return gates_1.SpecAcceptanceGate; } });
+Object.defineProperty(exports, "CommandGate", { enumerable: true, get: function () { return gates_1.CommandGate; } });
+Object.defineProperty(exports, "createCommandGate", { enumerable: true, get: function () { return gates_1.createCommandGate; } });
+Object.defineProperty(exports, "getCommandGate", { enumerable: true, get: function () { return gates_1.getCommandGate; } });
+Object.defineProperty(exports, "isCommandAllowed", { enumerable: true, get: function () { return gates_1.isCommandAllowed; } });
+Object.defineProperty(exports, "getCommandRiskLevel", { enumerable: true, get: function () { return gates_1.getCommandRiskLevel; } });
+Object.defineProperty(exports, "DEFAULT_COMMAND_BLACKLIST", { enumerable: true, get: function () { return gates_1.DEFAULT_COMMAND_BLACKLIST; } });
+Object.defineProperty(exports, "createReviewGate", { enumerable: true, get: function () { return gates_1.createReviewGate; } });
+Object.defineProperty(exports, "createSecurityGate", { enumerable: true, get: function () { return gates_1.createSecurityGate; } });
+Object.defineProperty(exports, "createPerformanceGate", { enumerable: true, get: function () { return gates_1.createPerformanceGate; } });
+Object.defineProperty(exports, "createContractGate", { enumerable: true, get: function () { return gates_1.createContractGate; } });
+Object.defineProperty(exports, "createSpecAcceptanceGate", { enumerable: true, get: function () { return gates_1.createSpecAcceptanceGate; } });
+Object.defineProperty(exports, "decisionFromResult", { enumerable: true, get: function () { return gates_1.decisionFromResult; } });
+Object.defineProperty(exports, "GATE_DEFINITIONS", { enumerable: true, get: function () { return gates_1.GATE_DEFINITIONS; } });
+Object.defineProperty(exports, "getGate", { enumerable: true, get: function () { return gates_1.getGate; } });
+Object.defineProperty(exports, "listRegisteredGates", { enumerable: true, get: function () { return gates_1.listRegisteredGates; } });
+Object.defineProperty(exports, "registeredGateCount", { enumerable: true, get: function () { return gates_1.registeredGateCount; } });
+Object.defineProperty(exports, "assertGateRegistryClosed", { enumerable: true, get: function () { return gates_1.assertGateRegistryClosed; } });
+Object.defineProperty(exports, "runGates", { enumerable: true, get: function () { return gates_1.runGates; } });
+Object.defineProperty(exports, "getEffectiveGates", { enumerable: true, get: function () { return gates_1.getEffectiveGates; } });
+Object.defineProperty(exports, "createCheckerGate", { enumerable: true, get: function () { return gates_1.createCheckerGate; } });
+// ========================================
+// 监控（Execution Trace 收集/分析 + 上下文追踪）
+// ========================================
+var trace_1 = require("./types/trace");
+Object.defineProperty(exports, "DEFAULT_TRACE_FILE", { enumerable: true, get: function () { return trace_1.DEFAULT_TRACE_FILE; } });
+var monitoring_1 = require("./monitoring");
+Object.defineProperty(exports, "TraceCollector", { enumerable: true, get: function () { return monitoring_1.TraceCollector; } });
+Object.defineProperty(exports, "getTraceCollector", { enumerable: true, get: function () { return monitoring_1.getTraceCollector; } });
+Object.defineProperty(exports, "configureTraceCollector", { enumerable: true, get: function () { return monitoring_1.configureTraceCollector; } });
+Object.defineProperty(exports, "TraceAnalyzer", { enumerable: true, get: function () { return monitoring_1.TraceAnalyzer; } });
+Object.defineProperty(exports, "createAnalyzer", { enumerable: true, get: function () { return monitoring_1.createAnalyzer; } });
+Object.defineProperty(exports, "ContextTracker", { enumerable: true, get: function () { return monitoring_1.ContextTracker; } });
+// ========================================
+// 失败处理（错误分类 + 记录 + 违规处理策略）
+// ========================================
+var failure_1 = require("./failure");
+Object.defineProperty(exports, "ErrorType", { enumerable: true, get: function () { return failure_1.ErrorType; } });
+Object.defineProperty(exports, "FailureLevel", { enumerable: true, get: function () { return failure_1.FailureLevel; } });
+Object.defineProperty(exports, "DEFAULT_CLASSIFICATION_RULES", { enumerable: true, get: function () { return failure_1.DEFAULT_CLASSIFICATION_RULES; } });
+Object.defineProperty(exports, "DEFAULT_LEVEL_MAPPING", { enumerable: true, get: function () { return failure_1.DEFAULT_LEVEL_MAPPING; } });
+Object.defineProperty(exports, "ErrorClassifier", { enumerable: true, get: function () { return failure_1.ErrorClassifier; } });
+Object.defineProperty(exports, "createErrorClassifier", { enumerable: true, get: function () { return failure_1.createErrorClassifier; } });
+Object.defineProperty(exports, "classifyError", { enumerable: true, get: function () { return failure_1.classifyError; } });
+Object.defineProperty(exports, "getFailureLevel", { enumerable: true, get: function () { return failure_1.getFailureLevel; } });
+Object.defineProperty(exports, "FailureRecorder", { enumerable: true, get: function () { return failure_1.FailureRecorder; } });
+Object.defineProperty(exports, "createFailureRecorder", { enumerable: true, get: function () { return failure_1.createFailureRecorder; } });
+Object.defineProperty(exports, "ConstraintViolationHandler", { enumerable: true, get: function () { return failure_1.ConstraintViolationHandler; } });
+Object.defineProperty(exports, "executeWithBlock", { enumerable: true, get: function () { return failure_1.executeWithBlock; } });
+Object.defineProperty(exports, "executeWithCollect", { enumerable: true, get: function () { return failure_1.executeWithCollect; } });
+Object.defineProperty(exports, "executeWithSafeBoolean", { enumerable: true, get: function () { return failure_1.executeWithSafeBoolean; } });
+// ========================================
+// 上下文管理（Token 预算 + 会话压缩 + 知识注入）
+// ========================================
+var context_1 = require("./context");
+Object.defineProperty(exports, "AdaptiveTokenBudget", { enumerable: true, get: function () { return context_1.AdaptiveTokenBudget; } });
+Object.defineProperty(exports, "TokenBudget", { enumerable: true, get: function () { return context_1.TokenBudget; } });
+Object.defineProperty(exports, "TokenEstimator", { enumerable: true, get: function () { return context_1.TokenEstimator; } });
+Object.defineProperty(exports, "DEFAULT_COMPACTION_CONFIG", { enumerable: true, get: function () { return context_1.DEFAULT_COMPACTION_CONFIG; } });
+Object.defineProperty(exports, "SessionCompaction", { enumerable: true, get: function () { return context_1.SessionCompaction; } });
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return context_1.SessionManager; } });
+Object.defineProperty(exports, "KnowledgeInjector", { enumerable: true, get: function () { return context_1.KnowledgeInjector; } });
+// ========================================
+// 知识引擎（Knowledge 基建）
+// ========================================
+var knowledge_1 = require("./knowledge");
+Object.defineProperty(exports, "FileKnowledgeStore", { enumerable: true, get: function () { return knowledge_1.FileKnowledgeStore; } });
+Object.defineProperty(exports, "KnowledgeQuery", { enumerable: true, get: function () { return knowledge_1.KnowledgeQuery; } });
+Object.defineProperty(exports, "KnowledgeLifecycle", { enumerable: true, get: function () { return knowledge_1.KnowledgeLifecycle; } });
+Object.defineProperty(exports, "KnowledgeIngest", { enumerable: true, get: function () { return knowledge_1.KnowledgeIngest; } });
+Object.defineProperty(exports, "sanitizeExternalContent", { enumerable: true, get: function () { return knowledge_1.sanitizeExternalContent; } });
+Object.defineProperty(exports, "ReferenceTracker", { enumerable: true, get: function () { return knowledge_1.ReferenceTracker; } });
+Object.defineProperty(exports, "KnowledgeLinter", { enumerable: true, get: function () { return knowledge_1.KnowledgeLinter; } });
+Object.defineProperty(exports, "ColdStartImporter", { enumerable: true, get: function () { return knowledge_1.ColdStartImporter; } });
+Object.defineProperty(exports, "KnowledgeHealthScorer", { enumerable: true, get: function () { return knowledge_1.KnowledgeHealthScorer; } });
+Object.defineProperty(exports, "KnowledgeLifecycleHooks", { enumerable: true, get: function () { return knowledge_1.KnowledgeLifecycleHooks; } });
+Object.defineProperty(exports, "KnowledgeAudit", { enumerable: true, get: function () { return knowledge_1.KnowledgeAudit; } });
+Object.defineProperty(exports, "migrateKnowledgeEntries", { enumerable: true, get: function () { return knowledge_1.migrateKnowledgeEntries; } });
+Object.defineProperty(exports, "extractCodeStructure", { enumerable: true, get: function () { return knowledge_1.extractCodeStructure; } });
+Object.defineProperty(exports, "DEFAULT_DECAY_CONFIG", { enumerable: true, get: function () { return knowledge_1.DEFAULT_DECAY_CONFIG; } });
+// ========================================
+// Completion Checkers（T7-E1，studio#160）
+// WU 收尾软观测三纯判定函数：tdd-chain / phase-format / contract-presence。
+// 纯函数直接 export，不进 ConstraintCheck 闭环注册表。
 // ========================================
-// 便捷 API
-// ========================================
-const checker_1 = require("./core/constraints/checker");
-const traces_1 = require("./monitoring/traces");
-const interceptor_1 = require("./core/constraints/interceptor");
-// 工单 15：checker 的 trace 记录改为注入式，根入口在此接入真实收集器（保持既有行为）
-checker_1.constraintChecker.setTraceRecorder((0, traces_1.getTraceCollector)());
-/** 约束拦截器单例，用于注册 enforcement executor 和拦截操作 */
-exports.interceptor = interceptor_1.constraintInterceptor;
-/**
- * 拦截操作 — 在操作执行前检查约束
- * @param trigger - 触发条件
- * @param context - 约束上下文
- * @param customConfig - 可选，per-request 自定义约束配置；不传则用内置约束集
- * @returns 拦截结果（是否通过、违规列表）
- */
-async function interceptOperation(trigger, context, customConfig) {
-    return interceptor_1.constraintInterceptor.intercept(trigger, context, customConfig);
-}
-/**
- * 声明操作意图 — 声明即将执行的操作，但不执行检查
- * @param trigger - 触发条件
- * @param context - 约束上下文
- */
-async function claimOperation(trigger, context) {
-    return interceptor_1.constraintInterceptor.claim(trigger, context);
-}
-/**
- * 注册 enforcement executor — 将 enforcement ID 连接到实际检查逻辑
- * @param enforcementId - enforcement ID（对应约束定义中的 enforcement 字段）
- * @param executor - 执行器实现
- * @param source - 注册来源（如 'builtin', 'plugin'）
- */
-function registerExecutor(enforcementId, executor, source) {
-    interceptor_1.constraintInterceptor.register(enforcementId, executor, source);
-}
-/**
- * 检查约束（check 层）
- *
- * @param context - 约束上下文
- * @param options.onTrace - 每条约束检查后的回调（用于记录 trace 到外部存储）
- * @param options.customConfig - 可选，per-request 自定义约束配置；不传则用内置约束集
- */
-async function checkConstraints(context, options) {
-    const result = await checker_1.constraintChecker.checkConstraints(context, options?.customConfig ?? null);
-    if (options?.onTrace) {
-        for (const r of result.ironLaws)
-            options.onTrace(r);
-        for (const r of result.guidelines)
-            options.onTrace(r);
-    }
-    return result;
-}
-/**
- * 执行前检查（仅 Iron Laws）
- *
- * @param context - 约束上下文
- * @param customConfig - 可选，per-request 自定义约束配置；不传则用内置约束集
- */
-async function checkBeforeExecution(context, customConfig) {
-    return checker_1.constraintChecker.beforeExecution(context, customConfig);
-}
+var completion_checkers_1 = require("./completion-checkers");
+Object.defineProperty(exports, "DEFAULT_TEST_GLOBS", { enumerable: true, get: function () { return completion_checkers_1.DEFAULT_TEST_GLOBS; } });
+Object.defineProperty(exports, "DEFAULT_NONCODE_GLOBS", { enumerable: true, get: function () { return completion_checkers_1.DEFAULT_NONCODE_GLOBS; } });
+Object.defineProperty(exports, "matchGlob", { enumerable: true, get: function () { return completion_checkers_1.matchGlob; } });
+Object.defineProperty(exports, "matchAnyGlob", { enumerable: true, get: function () { return completion_checkers_1.matchAnyGlob; } });
+Object.defineProperty(exports, "classifyCommitFiles", { enumerable: true, get: function () { return completion_checkers_1.classifyCommitFiles; } });
+Object.defineProperty(exports, "resolveGlobs", { enumerable: true, get: function () { return completion_checkers_1.resolveGlobs; } });
+Object.defineProperty(exports, "verifyTddChain", { enumerable: true, get: function () { return completion_checkers_1.verifyTddChain; } });
+Object.defineProperty(exports, "TESTED_BY_RE", { enumerable: true, get: function () { return completion_checkers_1.TESTED_BY_RE; } });
+Object.defineProperty(exports, "TESTS_NONE_RE", { enumerable: true, get: function () { return completion_checkers_1.TESTS_NONE_RE; } });
+Object.defineProperty(exports, "verifyPhaseFormat", { enumerable: true, get: function () { return completion_checkers_1.verifyPhaseFormat; } });
+Object.defineProperty(exports, "PHASE_SUBJECT_RE", { enumerable: true, get: function () { return completion_checkers_1.PHASE_SUBJECT_RE; } });
+Object.defineProperty(exports, "verifyContractPresence", { enumerable: true, get: function () { return completion_checkers_1.verifyContractPresence; } });
+// ========================================
+// 工具路径
+// ========================================
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "getRegistryPath", { enumerable: true, get: function () { return tools_1.getRegistryPath; } });
+Object.defineProperty(exports, "getToolsDir", { enumerable: true, get: function () { return tools_1.getToolsDir; } });
+// ========================================
+// Hooks 管线
+// ========================================
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "HookRegistry", { enumerable: true, get: function () { return hooks_1.HookRegistry; } });
+Object.defineProperty(exports, "assertHookRegistryClosed", { enumerable: true, get: function () { return hooks_1.assertHookRegistryClosed; } });
+Object.defineProperty(exports, "HookPipeline", { enumerable: true, get: function () { return hooks_1.HookPipeline; } });
+Object.defineProperty(exports, "toErrorStrategy", { enumerable: true, get: function () { return hooks_1.toErrorStrategy; } });
+Object.defineProperty(exports, "bootstrapHarness", { enumerable: true, get: function () { return hooks_1.bootstrapHarness; } });
+Object.defineProperty(exports, "bootstrapHarnessSync", { enumerable: true, get: function () { return hooks_1.bootstrapHarnessSync; } });
+// ========================================
+// Agent 生命周期
+// ========================================
+var agents_1 = require("./agents");
+Object.defineProperty(exports, "AgentLifecycle", { enumerable: true, get: function () { return agents_1.AgentLifecycle; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/knowledge/query.d.ts

@@ -21,6 +21,21 @@ export declare class KnowledgeQuery {
      * - Caches results per phase+budget key (TTL 5 min)
      */
     query(budget: QueryBudget, filter?: QueryFilter): QueryResult;
+    /**
+     * Full-text search over the entire corpus.
+     *
+     * Unlike query(), this is NOT budget-constrained: text matching runs on the
+     * full (filtered) corpus first, then results are sorted by
+     * maturity desc → lastReferenced desc and capped at `limit`.
+     * Token budgets only make sense for prompt injection (query()); interactive
+     * search must see every entry or low-ranked entries become unfindable.
+     *
+     * No caching and no recordReference side effect — searching is not citing.
+     */
+    search(query: string, options?: {
+        limit?: number;
+        filter?: QueryFilter;
+    }): KnowledgeEntry[];
     /**
      * Estimate token count for a piece of text.
      * Rule of thumb: 1 CJK char ≈ 2 tokens, 1 ASCII char ≈ 0.25 tokens.

package/dist/knowledge/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/knowledge/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EACf,WAAW,EACX,WAAW,EACX,WAAW,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAuBjD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,KAAK,CAAiC;gBAElC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,kBAAkB;IAKjE;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW;IA+B7D;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAapC,6BAA6B;IAC7B,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,EAAE;IAO1E;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,EAAE;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG;QAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAAC,UAAU,EAAE,cAAc,EAAE,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE;IAgBxF;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAWrD,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,QAAQ;IAIhB,gFAAgF;IAChF,OAAO,CAAC,YAAY;CAerB"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/knowledge/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EACf,WAAW,EACX,WAAW,EACX,WAAW,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAuBjD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,KAAK,CAAiC;gBAElC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,kBAAkB;IAKjE;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW;IA+B7D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,cAAc,EAAE;IAiB3F;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAapC,6BAA6B;IAC7B,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,EAAE;IAO1E;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,EAAE;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG;QAAE,KAAK,EAAE,cAAc,EAAE,CAAC;QAAC,UAAU,EAAE,cAAc,EAAE,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE;IAgBxF;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAWrD,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,QAAQ;IAIhB,gFAAgF;IAChF,OAAO,CAAC,YAAY;CAerB"}

package/dist/knowledge/query.js

@@ -61,6 +61,29 @@ class KnowledgeQuery {
         }
         return result;
     }
+    /**
+     * Full-text search over the entire corpus.
+     *
+     * Unlike query(), this is NOT budget-constrained: text matching runs on the
+     * full (filtered) corpus first, then results are sorted by
+     * maturity desc → lastReferenced desc and capped at `limit`.
+     * Token budgets only make sense for prompt injection (query()); interactive
+     * search must see every entry or low-ranked entries become unfindable.
+     *
+     * No caching and no recordReference side effect — searching is not citing.
+     */
+    search(query, options) {
+        const limit = options?.limit ?? 20;
+        const candidates = this.store.list({
+            excludeArchived: true,
+            ...options?.filter,
+        });
+        const q = query.toLowerCase();
+        const matched = candidates.filter(e => e.title.toLowerCase().includes(q) ||
+            e.content.toLowerCase().includes(q) ||
+            e.tags.some(t => t.toLowerCase().includes(q)));
+        return this.sortEntries(matched).slice(0, limit);
+    }
     /**
      * Estimate token count for a piece of text.
      * Rule of thumb: 1 CJK char ≈ 2 tokens, 1 ASCII char ≈ 0.25 tokens.

package/dist/knowledge/query.js.map

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

package/dist/monitoring/analyzer-base.d.ts

@@ -17,10 +17,6 @@ export declare function timeRangeOf(timestamps: number[]): {
     start: number;
     end: number;
 };
-/**
- * 找出出现次数最多的元素
- */
-export declare function findMostCommon(items: string[]): string | undefined;
 /**
  * 平均值
  */

package/dist/monitoring/analyzer-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzer-base.d.ts","sourceRoot":"","sources":["../../src/monitoring/analyzer-base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpD;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAStF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAKhF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAiBlE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAInF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAMzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMhE"}
+{"version":3,"file":"analyzer-base.d.ts","sourceRoot":"","sources":["../../src/monitoring/analyzer-base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpD;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAStF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAKhF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAInF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAMzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMhE"}

package/dist/monitoring/analyzer-base.js

@@ -43,7 +43,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIN_TREND_SAMPLES = void 0;
 exports.groupByKey = groupByKey;
 exports.timeRangeOf = timeRangeOf;
-exports.findMostCommon = findMostCommon;
 exports.calcAverage = calcAverage;
 exports.calcPercentile = calcPercentile;
 exports.splitByTime = splitByTime;
@@ -73,26 +72,6 @@ function timeRangeOf(timestamps) {
         end: Math.max(...timestamps),
     };
 }
-/**
- * 找出出现次数最多的元素
- */
-function findMostCommon(items) {
-    if (items.length === 0)
-        return undefined;
-    const counts = new Map();
-    for (const item of items) {
-        counts.set(item, (counts.get(item) || 0) + 1);
-    }
-    let maxCount = 0;
-    let mostCommon;
-    for (const [item, count] of counts) {
-        if (count > maxCount) {
-            maxCount = count;
-            mostCommon = item;
-        }
-    }
-    return mostCommon;
-}
 /**
  * 平均值
  */

package/dist/monitoring/analyzer-base.js.map

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

package/dist/monitoring/index.d.ts

@@ -4,18 +4,12 @@
  * Execution Trace 系统：
  * - TraceCollector：轻量收集，零 Token
  * - TraceAnalyzer：统计汇总，异常检测
- * - ConstraintDoctor：Agent 诊断接口
  *
- * Performance Trace 系统：
- * - PerformanceCollector：性能日志收集，零 Token
- * - PerformanceAnalyzer：统计汇总，异常检测
+ * 上下文使用追踪：
+ * - ContextTracker：LLM 调用上下文快照记录
  */
-export * from './traces';
-export * from './trace-analyzer';
-export * from './constraint-doctor';
-export * from './performance-collector';
-export * from './performance-analyzer';
-export * from './context-tracker';
-export { KnowledgeDoctor } from './knowledge-doctor';
-export { KnowledgeEvolver } from './knowledge-evolver';
+export { TraceCollector, getTraceCollector, configureTraceCollector, DEFAULT_TRACE_FILE } from './traces';
+export { TraceAnalyzer, createAnalyzer } from './trace-analyzer';
+export { ContextTracker } from './context-tracker';
+export type { ContextAverages } from './context-tracker';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monitoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}