soloforge 1.2.19 → 1.3.0

package/dist/engine/core_experience_principle.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Core Experience Principle — 问题五十六核心机制。
+ *
+ * 核心原则: 机制强，路径短；规则硬，体验轻；证据足，不啰嗦；能自动修复，不假装完成。
+ *
+ * 约束所有机制的最终使用形态，防止系统在"治理更强"的同时
+ * 退化成用户路径复杂、输出冗长、规则软化或假完成。
+ */
+/** 核心体验原则契约 */
+export interface CoreExperiencePrincipleContract {
+    contract_id: "CoreExperiencePrinciple";
+    mechanism_strength: {
+        real_mainline_hooks: string[];
+        hard_fail_rules: string[];
+        owner_contracts: string[];
+        evidence_required: string[];
+    };
+    path_shortness: {
+        user_entrypoints: string[];
+        hidden_internal_steps: string[];
+        max_user_required_decisions: number;
+        no_internal_contract_required: boolean;
+        natural_language_supported: boolean;
+    };
+    rule_hardness: {
+        hard_fail_conditions: string[];
+        manual_required_conditions: string[];
+        cannot_downgrade_to_warning: string[];
+    };
+    experience_lightness: {
+        risk_based_detail_level: "brief" | "normal" | "full";
+        user_visible_summary_required: boolean;
+        internal_trace_hidden_by_default: boolean;
+        avoid_repeated_confirmation: boolean;
+    };
+    evidence_sufficiency: {
+        required_refs: string[];
+        user_visible_evidence_summary: string[];
+        audit_trace_refs: string[];
+        no_raw_noise: boolean;
+    };
+    repair_truthfulness: {
+        auto_repair_allowed: boolean;
+        repair_reverify_required: boolean;
+        manual_required_when_unfixable: boolean;
+        cannot_mark_done_on_failure: boolean;
+    };
+}
+/** 核心体验原则评估 */
+export interface CoreExperiencePrincipleEvaluation {
+    task_id: string;
+    workflow_id: string;
+    evaluated_principles: Array<"strong_mechanism_short_path" | "hard_rules_light_experience" | "sufficient_evidence_concise_output" | "auto_repair_no_fake_completion">;
+    violations: CoreExperienceViolation[];
+    user_facing_summary_zh: string;
+    internal_trace_refs: string[];
+    passed: boolean;
+}
+/** 核心体验违规 */
+export interface CoreExperienceViolation {
+    principle: string;
+    severity: "info" | "warning" | "blocking";
+    reason_zh: string;
+    evidence_refs: string[];
+    required_action: "continue" | "simplify_output" | "repair_reverify" | "manual_required" | "block_delivery";
+}
+/** 用户路径摩擦报告 */
+export interface UserPathFrictionReport {
+    task_id: string;
+    friction_points: Array<{
+        step: string;
+        description_zh: string;
+        severity: "low" | "medium" | "high";
+    }>;
+    total_steps: number;
+    max_expected_steps: number;
+    passed: boolean;
+    suggestions_zh: string[];
+}
+/** 证据充足性报告 */
+export interface EvidenceSufficiencyReport {
+    task_id: string;
+    required_evidence_types: string[];
+    collected_evidence: string[];
+    missing_evidence: string[];
+    evidence_quality: "sufficient" | "insufficient" | "noisy";
+    passed: boolean;
+    issues_zh: string[];
+}
+/** 修复或需要人工决策 */
+export interface RepairOrManualRequiredDecision {
+    task_id: string;
+    decision: "repair_reverify" | "manual_required" | "completed" | "blocked";
+    reason_zh: string;
+    auto_repairable: boolean;
+    repair_scope: string[];
+    manual_required_reason?: string;
+    evidence_refs: string[];
+}
+export declare const CORE_EXPERIENCE_DIAGNOSTIC_CODES: Record<string, string>;
+/**
+ * 评估核心体验原则 — 检查任务执行是否遵守四条核心原则。
+ */
+export declare function evaluateCoreExperiencePrinciple(params: {
+    task_id: string;
+    workflow_id: string;
+    /** 机制是否有真实 mainline hook */
+    has_mainline_hooks: boolean;
+    /** 机制是否有 owner contract */
+    has_owner_contracts: boolean;
+    /** 用户入口是否可用自然语言触发 */
+    natural_language_entry: boolean;
+    /** 用户是否需要理解内部 contract */
+    requires_internal_contract_knowledge: boolean;
+    /** 用户路径步数 */
+    user_path_steps: number;
+    /** 是否有关键失败 */
+    has_failures: boolean;
+    /** 硬失败是否被降级 */
+    hard_fail_downgraded: boolean;
+    /** 低风险任务是否被强制重流程 */
+    forced_heavy_process: boolean;
+    /** 是否有足够证据 */
+    has_sufficient_evidence: boolean;
+    /** 输出是否过长且无摘要 */
+    output_too_long_no_summary: boolean;
+    /** 是否只报告问题不修复 */
+    report_only_no_repair: boolean;
+    /** 失败后是否标记完成 */
+    failed_but_marked_done: boolean;
+    /** 自动修复是否越权 */
+    auto_repair_overreach: boolean;
+    /** 修复后是否重验证 */
+    repair_reverified: boolean;
+    /** 是否输出原始日志 */
+    outputs_raw_noise: boolean;
+}): CoreExperiencePrincipleEvaluation;
+/**
+ * 评估用户可见输出质量。
+ */
+export declare function evaluateUserVisibleOutput(params: {
+    has_conclusion_first: boolean;
+    has_clear_summary: boolean;
+    has_actionable_next_step: boolean;
+    exposes_internal_noise: boolean;
+    hides_critical_failure: boolean;
+    chinese_semantic_first: boolean;
+}): {
+    passed: boolean;
+    issues_zh: string[];
+};
+/**
+ * 评估是否假完成 — 验证失败时是否错误标记为 completed。
+ */
+export declare function evaluateNoFalseCompletion(params: {
+    verification_passed: boolean;
+    build_passed: boolean;
+    browser_acceptance_passed: boolean;
+    guard_passed: boolean;
+    evidence_sufficient: boolean;
+    current_status: string;
+}): RepairOrManualRequiredDecision;
+/**
+ * 评估机制摩擦 — 新增机制是否过度增加了任务复杂度。
+ */
+export declare function evaluateMechanismFriction(params: {
+    added_steps: number;
+    baseline_steps: number;
+    risk_level: "low" | "medium" | "high";
+    has_necessity_justification: boolean;
+    has_lightweight_path: boolean;
+}): {
+    passed: boolean;
+    friction_score: number;
+    reason_zh: string;
+};
+/**
+ * 创建核心体验原则契约实例。
+ */
+export declare function createCoreExperiencePrincipleContract(overrides?: Partial<CoreExperiencePrincipleContract>): CoreExperiencePrincipleContract;
+/** 记录 CEP 在真实主链路中的调用 */
+export declare function recordCepIntegration(entryPoint: string, result: {
+    passed: boolean;
+    violations: CoreExperienceViolation[];
+}): void;
+/** 获取所有已记录的 CEP 集成 */
+export declare function getCepIntegrations(): Record<string, {
+    passed: boolean;
+    violations_count: number;
+    recorded_at: string;
+}>;
+/** 清空 CEP 集成记录 */
+export declare function clearCepIntegrations(): void;
+//# sourceMappingURL=core_experience_principle.d.ts.map

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

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

package/dist/engine/core_experience_principle.js

@@ -0,0 +1,349 @@
+/**
+ * Core Experience Principle — 问题五十六核心机制。
+ *
+ * 核心原则: 机制强，路径短；规则硬，体验轻；证据足，不啰嗦；能自动修复，不假装完成。
+ *
+ * 约束所有机制的最终使用形态，防止系统在"治理更强"的同时
+ * 退化成用户路径复杂、输出冗长、规则软化或假完成。
+ */
+// ── 诊断码 ──
+export const CORE_EXPERIENCE_DIAGNOSTIC_CODES = {
+    "SF-EXP-5601": "机制未接入真实主链路",
+    "SF-EXP-5602": "用户路径过长或要求用户理解内部 contract",
+    "SF-EXP-5603": "硬规则被降级为 warning",
+    "SF-EXP-5604": "低风险任务体验过重",
+    "SF-EXP-5605": "证据不足但输出完成",
+    "SF-EXP-5606": "用户输出冗长且缺少清晰结论",
+    "SF-EXP-5607": "失败未进入 repair_reverify 或 manual_required",
+    "SF-EXP-5608": "自动修复越过 scope 或用户确认",
+    "SF-EXP-5609": "修复后缺少重新验证",
+    "SF-EXP-5610": "用户项目 adapter 未注入核心体验原则",
+};
+// ── 核心函数 ──
+/**
+ * 评估核心体验原则 — 检查任务执行是否遵守四条核心原则。
+ */
+export function evaluateCoreExperiencePrinciple(params) {
+    const { task_id, workflow_id, has_mainline_hooks, has_owner_contracts, natural_language_entry, requires_internal_contract_knowledge, user_path_steps, has_failures, hard_fail_downgraded, forced_heavy_process, has_sufficient_evidence, output_too_long_no_summary, report_only_no_repair, failed_but_marked_done, auto_repair_overreach, repair_reverified, outputs_raw_noise, } = params;
+    const violations = [];
+    // 原则 1: 机制强，路径短
+    if (!has_mainline_hooks) {
+        violations.push({
+            principle: "strong_mechanism_short_path",
+            severity: "blocking",
+            reason_zh: "机制未接入真实主链路，只存在于文档、模板或测试中",
+            evidence_refs: [],
+            required_action: "block_delivery",
+        });
+    }
+    if (requires_internal_contract_knowledge) {
+        violations.push({
+            principle: "strong_mechanism_short_path",
+            severity: "blocking",
+            reason_zh: "用户路径要求用户理解内部 contract 名称才能触发核心 workflow",
+            evidence_refs: [],
+            required_action: "simplify_output",
+        });
+    }
+    if (user_path_steps > 5) {
+        violations.push({
+            principle: "strong_mechanism_short_path",
+            severity: "warning",
+            reason_zh: `用户路径过长 (${user_path_steps} 步)，应简化入口`,
+            evidence_refs: [],
+            required_action: "simplify_output",
+        });
+    }
+    // 原则 2: 规则硬，体验轻
+    if (hard_fail_downgraded) {
+        violations.push({
+            principle: "hard_rules_light_experience",
+            severity: "blocking",
+            reason_zh: "硬规则被降级为 warning 后继续执行",
+            evidence_refs: [],
+            required_action: "block_delivery",
+        });
+    }
+    if (forced_heavy_process) {
+        violations.push({
+            principle: "hard_rules_light_experience",
+            severity: "blocking",
+            reason_zh: "低风险任务被强制要求长篇方案或全量审查",
+            evidence_refs: [],
+            required_action: "simplify_output",
+        });
+    }
+    // 原则 3: 证据足，不啰嗦
+    if (!has_sufficient_evidence) {
+        violations.push({
+            principle: "sufficient_evidence_concise_output",
+            severity: "blocking",
+            reason_zh: "证据不足但输出完成 — 只有一句[已完成]但无 evidence refs",
+            evidence_refs: [],
+            required_action: "block_delivery",
+        });
+    }
+    if (output_too_long_no_summary) {
+        violations.push({
+            principle: "sufficient_evidence_concise_output",
+            severity: "blocking",
+            reason_zh: "用户输出冗长且缺少清晰结论",
+            evidence_refs: [],
+            required_action: "simplify_output",
+        });
+    }
+    if (outputs_raw_noise) {
+        violations.push({
+            principle: "sufficient_evidence_concise_output",
+            severity: "warning",
+            reason_zh: "输出包含原始日志或内部流水账，未脱敏或摘要化",
+            evidence_refs: [],
+            required_action: "simplify_output",
+        });
+    }
+    // 原则 4: 能自动修复，不假装完成
+    if (failed_but_marked_done) {
+        violations.push({
+            principle: "auto_repair_no_fake_completion",
+            severity: "blocking",
+            reason_zh: "验证失败但标记为 completed/delivered，假完成",
+            evidence_refs: [],
+            required_action: "repair_reverify",
+        });
+    }
+    if (report_only_no_repair) {
+        violations.push({
+            principle: "auto_repair_no_fake_completion",
+            severity: "blocking",
+            reason_zh: "只报告发现问题，未进入 repair_reverify 或 manual_required",
+            evidence_refs: [],
+            required_action: "repair_reverify",
+        });
+    }
+    if (auto_repair_overreach) {
+        violations.push({
+            principle: "auto_repair_no_fake_completion",
+            severity: "blocking",
+            reason_zh: "自动修复越过用户确认或扩大 scope",
+            evidence_refs: [],
+            required_action: "manual_required",
+        });
+    }
+    if (has_failures && !repair_reverified) {
+        violations.push({
+            principle: "auto_repair_no_fake_completion",
+            severity: "blocking",
+            reason_zh: "修复后缺少重新验证",
+            evidence_refs: [],
+            required_action: "repair_reverify",
+        });
+    }
+    const blockingViolations = violations.filter((v) => v.severity === "blocking");
+    const passed = blockingViolations.length === 0;
+    return {
+        task_id: params.task_id,
+        workflow_id: params.workflow_id,
+        evaluated_principles: [
+            "strong_mechanism_short_path",
+            "hard_rules_light_experience",
+            "sufficient_evidence_concise_output",
+            "auto_repair_no_fake_completion",
+        ],
+        violations,
+        user_facing_summary_zh: passed
+            ? "核心体验原则评估通过"
+            : `核心体验原则评估未通过: ${blockingViolations.map((v) => v.reason_zh).join("; ")}`,
+        internal_trace_refs: [],
+        passed,
+    };
+}
+/**
+ * 评估用户可见输出质量。
+ */
+export function evaluateUserVisibleOutput(params) {
+    const issues = [];
+    if (!params.has_conclusion_first)
+        issues.push("用户可见输出未先给结论");
+    if (!params.has_clear_summary)
+        issues.push("用户可见输出缺少清晰摘要");
+    if (!params.has_actionable_next_step)
+        issues.push("用户可见输出缺少可执行的下一步");
+    if (params.exposes_internal_noise)
+        issues.push("用户可见输出暴露内部流水账");
+    if (params.hides_critical_failure)
+        issues.push("用户可见输出隐藏了关键失败");
+    if (!params.chinese_semantic_first)
+        issues.push("用户可见输出未中文语义优先");
+    return { passed: issues.length === 0, issues_zh: issues };
+}
+/**
+ * 评估是否假完成 — 验证失败时是否错误标记为 completed。
+ */
+export function evaluateNoFalseCompletion(params) {
+    const failures = [];
+    if (!params.verification_passed)
+        failures.push("验证失败");
+    if (!params.build_passed)
+        failures.push("构建失败");
+    if (!params.browser_acceptance_passed)
+        failures.push("浏览器验收失败");
+    if (!params.guard_passed)
+        failures.push("guard 阻断");
+    if (!params.evidence_sufficient)
+        failures.push("证据不足");
+    if (failures.length === 0) {
+        return {
+            task_id: "",
+            decision: "completed",
+            reason_zh: "所有验证通过，可完成",
+            auto_repairable: false,
+            repair_scope: [],
+            evidence_refs: [],
+        };
+    }
+    const isCompleted = ["completed", "delivered", "implemented_verified", "done"].includes(params.current_status);
+    if (isCompleted) {
+        return {
+            task_id: "",
+            decision: "blocked",
+            reason_zh: `假完成检测: ${failures.join(", ")}，但状态为 ${params.current_status}`,
+            auto_repairable: false,
+            repair_scope: [],
+            manual_required_reason: "不得将失败伪装成完成",
+            evidence_refs: [],
+        };
+    }
+    return {
+        task_id: "",
+        decision: "repair_reverify",
+        reason_zh: `${failures.join(", ")}，需进入 repair_reverify`,
+        auto_repairable: true,
+        repair_scope: [],
+        evidence_refs: [],
+    };
+}
+/**
+ * 评估机制摩擦 — 新增机制是否过度增加了任务复杂度。
+ */
+export function evaluateMechanismFriction(params) {
+    const addedRatio = params.added_steps / Math.max(params.baseline_steps, 1);
+    let tooMuchFriction = false;
+    if (params.risk_level === "low" && addedRatio > 0.5)
+        tooMuchFriction = true;
+    if (params.risk_level === "medium" && addedRatio > 1.0 && !params.has_lightweight_path)
+        tooMuchFriction = true;
+    if (tooMuchFriction && !params.has_necessity_justification) {
+        return {
+            passed: false,
+            friction_score: Math.round(addedRatio * 100),
+            reason_zh: `新增机制增加 ${params.added_steps} 步 (${Math.round(addedRatio * 100)}% 增长)，对 ${params.risk_level} 风险任务过度，需说明必要性或提供轻量路径`,
+        };
+    }
+    return {
+        passed: true,
+        friction_score: Math.round(addedRatio * 100),
+        reason_zh: "摩擦在可接受范围",
+    };
+}
+/**
+ * 创建核心体验原则契约实例。
+ */
+export function createCoreExperiencePrincipleContract(overrides) {
+    const base = {
+        contract_id: "CoreExperiencePrinciple",
+        mechanism_strength: {
+            real_mainline_hooks: [
+                "PlanProposalFirstGate",
+                "WorkflowContract",
+                "ToolInvocation",
+                "VerificationPlan",
+                "DeliveryReadiness",
+                "FailureReport",
+                "RepairLoop",
+            ],
+            hard_fail_rules: [
+                "无计划不得执行写入动作",
+                "高风险无确认不得执行",
+                "验证失败不得标记完成",
+                "guard 阻断不得继续",
+            ],
+            owner_contracts: [
+                "PlanProposalFirstGate",
+                "WorkflowContract",
+                "GuardEvaluationReport",
+                "VerificationPlan",
+                "DeliveryReadinessReport",
+                "FailureReport",
+            ],
+            evidence_required: ["plan_evidence", "execution_evidence", "verification_evidence", "delivery_evidence"],
+        },
+        path_shortness: {
+            user_entrypoints: ["自然语言意图", "CLI 命令"],
+            hidden_internal_steps: ["RouteDecision", "WorkflowContract解析", "ContractRegistry查询", "KnowledgeIndex构建"],
+            max_user_required_decisions: 3,
+            no_internal_contract_required: true,
+            natural_language_supported: true,
+        },
+        rule_hardness: {
+            hard_fail_conditions: ["安全边界突破", "scope 越权", "用户资产风险", "证据缺失", "核心契约违反"],
+            manual_required_conditions: ["用户选择方案", "scope 扩大", "高风险确认", "外部副作用", "不可自动修复"],
+            cannot_downgrade_to_warning: [
+                "安全/隐私违反",
+                "scope 越权",
+                "用户资产破坏性操作",
+                "证据链断裂",
+                "核心护栏穿透",
+            ],
+        },
+        experience_lightness: {
+            risk_based_detail_level: "normal",
+            user_visible_summary_required: true,
+            internal_trace_hidden_by_default: true,
+            avoid_repeated_confirmation: true,
+        },
+        evidence_sufficiency: {
+            required_refs: ["plan", "execution", "verification", "delivery"],
+            user_visible_evidence_summary: ["做了什么", "验证了什么", "还有什么风险"],
+            audit_trace_refs: ["plan_id", "verification_id", "delivery_id", "evidence_refs"],
+            no_raw_noise: true,
+        },
+        repair_truthfulness: {
+            auto_repair_allowed: true,
+            repair_reverify_required: true,
+            manual_required_when_unfixable: true,
+            cannot_mark_done_on_failure: true,
+        },
+    };
+    if (overrides) {
+        return {
+            ...base,
+            ...overrides,
+            mechanism_strength: { ...base.mechanism_strength, ...overrides.mechanism_strength },
+            path_shortness: { ...base.path_shortness, ...overrides.path_shortness },
+            rule_hardness: { ...base.rule_hardness, ...overrides.rule_hardness },
+            experience_lightness: { ...base.experience_lightness, ...overrides.experience_lightness },
+            evidence_sufficiency: { ...base.evidence_sufficiency, ...overrides.evidence_sufficiency },
+            repair_truthfulness: { ...base.repair_truthfulness, ...overrides.repair_truthfulness },
+        };
+    }
+    return base;
+}
+// ── CEP 集成追踪 — 真实接入路径证明 ──
+const _cepIntegrations = new Map();
+/** 记录 CEP 在真实主链路中的调用 */
+export function recordCepIntegration(entryPoint, result) {
+    _cepIntegrations.set(entryPoint, {
+        passed: result.passed,
+        violations_count: result.violations.length,
+        recorded_at: new Date().toISOString(),
+    });
+}
+/** 获取所有已记录的 CEP 集成 */
+export function getCepIntegrations() {
+    return Object.fromEntries(_cepIntegrations);
+}
+/** 清空 CEP 集成记录 */
+export function clearCepIntegrations() {
+    _cepIntegrations.clear();
+}
+//# sourceMappingURL=core_experience_principle.js.map

package/dist/engine/core_experience_principle.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"debt_reporter.d.ts","sourceRoot":"","sources":["../../src/engine/debt_reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AA4CxD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6DlF"}
+{"version":3,"file":"debt_reporter.d.ts","sourceRoot":"","sources":["../../src/engine/debt_reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AA6CxD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6DlF"}

package/dist/engine/debt_reporter.js

@@ -1,3 +1,4 @@
+import { debug } from "./logger.js";
 /**
  * 技术债务报告生成模块 — 基于债务追踪器数据，生成聚合统计报告。
  * 包括按类别/严重程度分组、最久未解决天数、趋势分析和优先级排序。
@@ -41,7 +42,7 @@ function computePriorityScore(item) {
  * @returns 债务报告，包含总数、分类统计、严重程度分布、最久未解决天数、趋势和中文摘要
  */
 export async function generateDebtReport(tracker) {
-    console.error("[soloForge] 技术债务: 开始生成技术债务报告");
+    debug("技术债务", "开始生成技术债务报告");
     const openItems = await tracker.listOpen();
     // 未解决的债务总数
     const total_open = openItems.length;
@@ -79,7 +80,7 @@ export async function generateDebtReport(tracker) {
     parts.push(`${criticalCount} critical, ${warningCount} warning, ${infoCount} info`);
     parts.push(`最久未解决: ${oldest_debt_days} 天`);
     const summary = parts.join("；") + "。";
-    console.error(`[soloForge] 技术债务: 生成完成 — ${summary}`);
+    debug("技术债务", `生成完成 — ${summary}`);
     return {
         total_open,
         by_category,

package/dist/engine/debt_reporter.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"debt_tracker.d.ts","sourceRoot":"","sources":["../../src/engine/debt_tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAW3E;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,WAAW,EAAE,MAAM;IAI/B,0BAA0B;IACpB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkCzE;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBrC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUjD;;;;OAIG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB9F;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAavC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BhC;;;;;OAKG;YACW,YAAY;CAgB3B"}
+{"version":3,"file":"debt_tracker.d.ts","sourceRoot":"","sources":["../../src/engine/debt_tracker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAY3E;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,WAAW,EAAE,MAAM;IAI/B,0BAA0B;IACpB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkCzE;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBrC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUjD;;;;OAIG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB9F;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAavC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BhC;;;;;OAKG;YACW,YAAY;CAgB3B"}