soloforge 1.1.2 → 1.1.30

package/dist/server/tools/schemas.d.ts

@@ -0,0 +1,187 @@
+import { z } from "zod";
+export declare const ClassifySchema: {
+    intent: z.ZodString;
+    project_path: z.ZodOptional<z.ZodString>;
+};
+export declare const ExpandSchema: {
+    task_id: z.ZodString;
+    clarification_answers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    input_material_confirmations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    architecture_decision_workshop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    decision_workshop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    technology_decision_contract: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    technology_decision_record: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    detail_discipline_contract: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    provided_details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    first_principles_frame: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    brainstorm_session: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    design_artifact_pack: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    ood_solid_summary: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    backend_implementation_work_package: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    code_observability_work_package: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+};
+export declare const VerifySchema: {
+    task_id: z.ZodString;
+    changed_files: z.ZodArray<z.ZodString, "many">;
+};
+export declare const LearnSchema: {
+    task_id: z.ZodString;
+    result: z.ZodEnum<["success", "failure"]>;
+    failure_type: z.ZodOptional<z.ZodEnum<["deterministic", "fixable", "scope_insufficient"]>>;
+    verify_output: z.ZodOptional<z.ZodObject<{
+        build_passed: z.ZodBoolean;
+        tests_passed: z.ZodBoolean;
+        acceptance_results: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        build_passed: boolean;
+        tests_passed: boolean;
+        acceptance_results?: Record<string, boolean> | undefined;
+    }, {
+        build_passed: boolean;
+        tests_passed: boolean;
+        acceptance_results?: Record<string, boolean> | undefined;
+    }>>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    authorized: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const StatusSchema: {
+    task_id: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodEnum<["current", "recent", "resume", "cancel", "archive_stale", "retry_expand"]>>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    authorized: z.ZodOptional<z.ZodBoolean>;
+    job_id: z.ZodOptional<z.ZodString>;
+    job_action: z.ZodOptional<z.ZodEnum<["job_status", "job_resume", "job_cancel"]>>;
+};
+export declare const PlanSchema: {
+    task_id: z.ZodString;
+};
+export declare const AnalyzeSchema: {
+    task_id: z.ZodString;
+};
+export declare const ReviewSchema: {
+    task_id: z.ZodString;
+    changed_files: z.ZodArray<z.ZodString, "many">;
+    file_contents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+};
+export declare const ScaffoldSchema: {
+    task_id: z.ZodString;
+};
+export declare const RecordVerificationExecutionSchema: {
+    task_id: z.ZodString;
+    plan_id: z.ZodString;
+    execution_records: z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        exit_code: z.ZodNumber;
+        stdout_hash: z.ZodString;
+        stderr_hash: z.ZodString;
+        started_at: z.ZodString;
+        finished_at: z.ZodString;
+        evidence_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        exit_code: number;
+        stdout_hash: string;
+        stderr_hash: string;
+        started_at: string;
+        finished_at: string;
+        evidence_id: string;
+    }, {
+        command: string;
+        exit_code: number;
+        stdout_hash: string;
+        stderr_hash: string;
+        started_at: string;
+        finished_at: string;
+        evidence_id: string;
+    }>, "many">;
+};
+export declare const AcceptSchema: {
+    task_id: z.ZodString;
+    confirm: z.ZodBoolean;
+    confirmed_by: z.ZodString;
+    confirmation_ref: z.ZodString;
+    acceptance_notes: z.ZodString;
+    run_mode: z.ZodEnum<["manual_review", "not_applicable"]>;
+    final_access: z.ZodOptional<z.ZodObject<{
+        frontend_urls: z.ZodArray<z.ZodString, "many">;
+        backend_urls: z.ZodArray<z.ZodString, "many">;
+        docs_or_swagger_urls: z.ZodArray<z.ZodString, "many">;
+        start_commands: z.ZodArray<z.ZodString, "many">;
+        stop_commands: z.ZodArray<z.ZodString, "many">;
+        running_status: z.ZodString;
+        manual_review_steps_zh: z.ZodArray<z.ZodString, "many">;
+        known_limits_zh: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        running_status: string;
+        frontend_urls: string[];
+        backend_urls: string[];
+        docs_or_swagger_urls: string[];
+        start_commands: string[];
+        stop_commands: string[];
+        manual_review_steps_zh: string[];
+        known_limits_zh: string[];
+    }, {
+        running_status: string;
+        frontend_urls: string[];
+        backend_urls: string[];
+        docs_or_swagger_urls: string[];
+        start_commands: string[];
+        stop_commands: string[];
+        manual_review_steps_zh: string[];
+        known_limits_zh: string[];
+    }>>;
+};
+export declare const DeliverSchema: {
+    task_id: z.ZodString;
+    changed_files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    skip_push: z.ZodOptional<z.ZodBoolean>;
+    skip_pr: z.ZodOptional<z.ZodBoolean>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+    authorized: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const CoordCheckSchema: {
+    task_id: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+};
+export declare const TeamStatusSchema: {
+    since: z.ZodOptional<z.ZodString>;
+    include_knowledge: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const ContractCheckSchema: {
+    task_id: z.ZodString;
+    changed_files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare const OnboardSchema: {
+    step: z.ZodOptional<z.ZodEnum<["project_overview", "code_tour", "knowledge_review", "first_task"]>>;
+    reset: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const FeasibilityCheckSchema: {
+    task_id: z.ZodString;
+};
+export declare const DebugSchema: {
+    error_output: z.ZodString;
+    task_id: z.ZodOptional<z.ZodString>;
+};
+export declare const ObservabilitySchema: {
+    period_days: z.ZodOptional<z.ZodNumber>;
+};
+export declare const MigrationCheckSchema: {
+    content: z.ZodString;
+    filename: z.ZodString;
+};
+export declare const TestGuideSchema: {
+    changed_files: z.ZodArray<z.ZodString, "many">;
+};
+export declare const TestQualitySchema: {
+    content: z.ZodString;
+    filename: z.ZodString;
+};
+export declare const DependencyScanSchema: {
+    content: z.ZodString;
+    filename: z.ZodString;
+};
+export declare const ExploreSchema: {
+    domain_query: z.ZodString;
+    task_id: z.ZodOptional<z.ZodString>;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/server/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/server/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc;;;CAG1B,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;CAgBxB,CAAC;AAEF,eAAO,MAAM,YAAY;;;CAGxB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;CAWvB,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;CAOxB,CAAC;AAEF,eAAO,MAAM,UAAU;;CAEtB,CAAC;AAEF,eAAO,MAAM,aAAa;;CAEzB,CAAC;AAEF,eAAO,MAAM,YAAY;;;;CAIxB,CAAC;AAEF,eAAO,MAAM,cAAc;;CAE1B,CAAC;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY7C,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;CAOzB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;CAG5B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;CAG5B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,eAAO,MAAM,aAAa;;;CAGzB,CAAC;AAEF,eAAO,MAAM,sBAAsB;;CAElC,CAAC;AAEF,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAEF,eAAO,MAAM,mBAAmB;;CAE/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;CAGhC,CAAC;AAEF,eAAO,MAAM,eAAe;;CAE3B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;CAGhC,CAAC;AAEF,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}

package/dist/server/tools/schemas.js

@@ -0,0 +1,146 @@
+import { z } from "zod";
+// ── Zod Schema 定义 ──
+export const ClassifySchema = {
+    intent: z.string().describe("开发者意图描述"),
+    project_path: z.string().optional().describe("项目路径（默认当前目录）"),
+};
+export const ExpandSchema = {
+    task_id: z.string().describe("sf_classify 返回的任务 ID"),
+    clarification_answers: z.array(z.string()).optional().describe("对澄清问题的回答"),
+    input_material_confirmations: z.array(z.string()).optional().describe("已确认安全的输入材料路径列表"),
+    architecture_decision_workshop: z.record(z.unknown()).optional().describe("架构设计前六域决策记录。示例 {domains:[{domain:'backend',options:[{id:'opt-a',title:'...'}],recommended_option_id:'opt-a',user_confirmation_ref:'confirm:...'}],status:'confirmed'}"),
+    decision_workshop: z.record(z.unknown()).optional().describe("通用决策研讨合同。示例 {activated_packs:['delivery_validation'],domains:[{domain:'delivery_validation',options:[{id:'opt-a',title:'...'}],recommended_option_id:'opt-a',user_confirmation_ref:'confirm:...'}],status:'confirmed'}"),
+    technology_decision_contract: z.record(z.unknown()).optional().describe("技术决策主权契约。示例 {decision_id:'TECH-001',decision_scope:'architecture',options:[{option_id:'opt-a',title:'A',description:'...'}],recommended_option:'opt-a',rejected_options:[{option:'opt-b',reason:'...'}],evidence:[{claim:'...',supporting_facts:['...']}],falsification:['...'],failure_conditions:['...'],validation_plan:['...'],rollback_or_exit_plan:['...'],human_gate_required:true,human_gate_evidence:'confirm:...',executable_without_human:false}"),
+    technology_decision_record: z.record(z.unknown()).optional().describe("技术决策执行记录。示例 {decision_id:'TECH-001',selected_option:'opt-a',status:'approved',approved_by:'user',evidence_refs:['confirm:...']}"),
+    detail_discipline_contract: z.record(z.unknown()).optional().describe("细节纪律契约。示例 {contract_id:'detail-001',required_dimensions:['boundary','failure_path','rollback'],blocking_dimensions:['boundary'],status:'ready'}"),
+    provided_details: z.record(z.unknown()).optional().describe("细节纪律已提供证据。示例 {boundary:['只检查 readiness，不改代码'],failure_path:['unknown 时标记证据不足'],rollback:['无写入，无需回滚']}"),
+    first_principles_frame: z.record(z.unknown()).optional().describe("高影响任务第一性原理框架。示例 {fundamental_need:'...',known_facts:['...'],assumptions:['...'],candidate_solutions:[{solution_id:'s1',description:'...',complexity:'low'}],simplest_viable_solution:'s1',chosen_solution:'s1',falsification_questions:['...'],why_not_legacy_path:'...'}"),
+    brainstorm_session: z.record(z.unknown()).optional().describe("不确定项/方案选择会话。示例 {trigger:'uncertainty',options:[{option_id:'opt-a',title:'...',description:'...',pros:['...'],cons:['...']}],recommended_option_id:'opt-a',rejected_option_ids:['opt-b'],failure_conditions:['...'],brainstorm_status:'options_ready'}"),
+    design_artifact_pack: z.record(z.unknown()).optional().describe("设计产物包路径映射或复验状态。示例 {status:'implementation_ready',paths:{architecture_document:'docs/architecture/01-架构设计文档.md'},verification_refs:['verification:...']}"),
+    ood_solid_summary: z.record(z.unknown()).optional().describe("复杂编码任务 OOD/SOLID 摘要。示例 {status:'confirmed',responsibilities:['...'],interfaces:['...'],risks:['...'],evidence_refs:['...']}"),
+    backend_implementation_work_package: z.record(z.unknown()).optional().describe("后端接口实现工程工作包。示例 {status:'confirmed',api_boundary:['...'],transaction_boundary:['...'],error_contract:['...'],evidence_refs:['...']}"),
+    code_observability_work_package: z.record(z.unknown()).optional().describe("代码可维护性与可观测性工作包。示例 {status:'confirmed',logging_plan:['...'],comment_plan:['...'],sensitive_logging_policy:'redact',evidence_refs:['...']}"),
+};
+export const VerifySchema = {
+    task_id: z.string().describe("任务 ID"),
+    changed_files: z.array(z.string()).describe("本次修改的文件列表"),
+};
+export const LearnSchema = {
+    task_id: z.string().describe("任务 ID"),
+    result: z.enum(["success", "failure"]).describe("执行结果"),
+    failure_type: z.enum(["deterministic", "fixable", "scope_insufficient"]).optional().describe("失败类型"),
+    verify_output: z.object({
+        build_passed: z.boolean(),
+        tests_passed: z.boolean(),
+        acceptance_results: z.record(z.string(), z.boolean()).optional(),
+    }).optional().describe("验证输出"),
+    confirm: z.boolean().optional().describe("确认执行学习（写入状态）"),
+    authorized: z.boolean().optional().describe("confirm 的兼容别名"),
+};
+export const StatusSchema = {
+    task_id: z.string().optional().describe("任务 ID（不传则查当前任务）"),
+    action: z.enum(["current", "recent", "resume", "cancel", "archive_stale", "retry_expand"]).optional().describe("操作类型"),
+    confirm: z.boolean().optional().describe("确认执行会写入状态的操作，例如 cancel/archive_stale/job_cancel"),
+    authorized: z.boolean().optional().describe("confirm 的兼容别名"),
+    job_id: z.string().optional().describe("Job ID（用于 job_status / job_resume / job_cancel）"),
+    job_action: z.enum(["job_status", "job_resume", "job_cancel"]).optional().describe("Job 操作: 查询状态、从 checkpoint 恢复、取消 job（advisory）"),
+};
+export const PlanSchema = {
+    task_id: z.string().describe("sf_classify 返回的任务 ID"),
+};
+export const AnalyzeSchema = {
+    task_id: z.string().describe("sf_expand 返回的任务 ID（需要先执行 expand）"),
+};
+export const ReviewSchema = {
+    task_id: z.string().describe("任务 ID"),
+    changed_files: z.array(z.string()).describe("本次修改的文件列表"),
+    file_contents: z.record(z.string(), z.string()).optional().describe("变更文件的当前内容（key=文件路径，value=文件内容），不传则自动读取"),
+};
+export const ScaffoldSchema = {
+    task_id: z.string().describe("sf_classify 返回的任务 ID（task_type 应为 scaffold）"),
+};
+export const RecordVerificationExecutionSchema = {
+    task_id: z.string().describe("任务 ID"),
+    plan_id: z.string().describe("关联的 VerificationPlan ID"),
+    execution_records: z.array(z.object({
+        command: z.string().describe("执行的验证命令"),
+        exit_code: z.number().describe("命令退出码，0 表示通过"),
+        stdout_hash: z.string().describe("stdout 的 SHA256 hash"),
+        stderr_hash: z.string().describe("stderr 的 SHA256 hash"),
+        started_at: z.string().describe("命令开始时间 ISO 8601"),
+        finished_at: z.string().describe("命令结束时间 ISO 8601"),
+        evidence_id: z.string().describe("执行证据 ID"),
+    })).describe("真实执行记录列表"),
+};
+export const AcceptSchema = {
+    task_id: z.string().describe("任务 ID"),
+    confirm: z.boolean().describe("用户显式确认验收结果，必须为 true"),
+    confirmed_by: z.string().describe("执行确认的用户或审批者标识"),
+    confirmation_ref: z.string().describe("可审计的用户确认引用"),
+    acceptance_notes: z.string().describe("验收备注或不适用理由"),
+    run_mode: z.enum(["manual_review", "not_applicable"]).describe("验收模式"),
+    final_access: z.object({
+        frontend_urls: z.array(z.string()),
+        backend_urls: z.array(z.string()),
+        docs_or_swagger_urls: z.array(z.string()),
+        start_commands: z.array(z.string()),
+        stop_commands: z.array(z.string()),
+        running_status: z.string(),
+        manual_review_steps_zh: z.array(z.string()),
+        known_limits_zh: z.array(z.string()),
+    }).optional().describe("manual_review 模式下的真实本地访问证据"),
+};
+export const DeliverSchema = {
+    task_id: z.string().describe("任务 ID"),
+    changed_files: z.array(z.string()).optional().describe("变更文件列表（不传则使用任务记录中的文件）"),
+    skip_push: z.boolean().optional().describe("跳过推送"),
+    skip_pr: z.boolean().optional().describe("跳过 PR 创建"),
+    confirm: z.boolean().optional().describe("确认执行交付（破坏性操作）"),
+    authorized: z.boolean().optional().describe("confirm 的兼容别名"),
+};
+export const CoordCheckSchema = {
+    task_id: z.string().optional().describe("任务 ID（用于获取变更文件列表）"),
+    branch: z.string().optional().describe("指定分支（不传则使用当前分支）"),
+};
+export const TeamStatusSchema = {
+    since: z.string().optional().describe("起始日期（ISO 格式，默认 7 天前）"),
+    include_knowledge: z.boolean().optional().describe("包含知识库更新信息"),
+};
+export const ContractCheckSchema = {
+    task_id: z.string().describe("任务 ID"),
+    changed_files: z.array(z.string()).optional().describe("变更文件列表（不传则从任务记录获取）"),
+};
+export const OnboardSchema = {
+    step: z.enum(["project_overview", "code_tour", "knowledge_review", "first_task"]).optional().describe("当前引导步骤"),
+    reset: z.boolean().optional().describe("重置引导会话"),
+};
+export const FeasibilityCheckSchema = {
+    task_id: z.string().describe("任务 ID（需要已完成 classify）"),
+};
+export const DebugSchema = {
+    error_output: z.string().describe("错误输出文本"),
+    task_id: z.string().optional().describe("关联任务 ID"),
+};
+export const ObservabilitySchema = {
+    period_days: z.number().optional().describe("报告周期天数（默认 30）"),
+};
+export const MigrationCheckSchema = {
+    content: z.string().describe("迁移文件内容（SQL/DDL）"),
+    filename: z.string().describe("文件名（如 V001__create_users.sql）"),
+};
+export const TestGuideSchema = {
+    changed_files: z.array(z.string()).describe("变更文件列表"),
+};
+export const TestQualitySchema = {
+    content: z.string().describe("测试文件内容"),
+    filename: z.string().describe("测试文件名"),
+};
+export const DependencyScanSchema = {
+    content: z.string().describe("依赖声明文件内容（package.json / pom.xml / build.gradle）"),
+    filename: z.string().describe("文件名"),
+};
+export const ExploreSchema = {
+    domain_query: z.string().describe("技术选型领域关键词（如：分布式锁、流式处理、复杂表单状态管理、缓存策略）"),
+    task_id: z.string().optional().describe("关联任务 ID（可选，用于关联项目上下文）"),
+};
+//# sourceMappingURL=schemas.js.map

package/dist/server/tools/schemas.js.map

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

package/dist/server/tools/tool_groups/admin.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistrationContext } from "../middleware.js";
+export declare function registerAdminTools(ctx: ToolRegistrationContext): Promise<void>;
+//# sourceMappingURL=admin.d.ts.map

package/dist/server/tools/tool_groups/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../../src/server/tools/tool_groups/admin.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAiBhE,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+VpF"}

package/dist/server/tools/tool_groups/admin.js

@@ -0,0 +1,267 @@
+// ── Tool Group: Admin / Infrastructure tools ──
+// sf_resume_workspace, sf_audit_sample, sf_escape_report,
+// sf_capability_update, sf_governance_report, sf_audit_integration, sf_navigation
+// Extracted from tools.ts lines 4567-4912.
+import { z } from "zod";
+import { internalWarn } from "../../../engine/core/logger.js";
+import { createToolRegistrar } from "../middleware.js";
+import { lazyWorkspaceResumer, lazyJob, lazyAuditPool, lazyEscape, lazyAuditSampler, lazyCapState, lazyCapability, lazyCapAdvisor, lazyDualLayer, lazyGovernance, lazyConfigPrecedence, lazyMainPath, } from "../lazy_loaders.js";
+export async function registerAdminTools(ctx) {
+    const { registerSafeTool, loadRelevantAnchors } = createToolRegistrar(ctx);
+    const { config, taskContext, projectPath } = ctx;
+    // ── sf_resume_workspace: 扫描恢复中断工单 ──
+    registerSafeTool("sf_resume_workspace", "扫描 .soloforge/state/ 目录，恢复中断工单并播报当前进度。新会话启动时必须优先调用", {}, async () => {
+        const result = await (await lazyWorkspaceResumer()).scanAndResume(taskContext);
+        // 认知锚点：按恢复任务的 changed_files 相关性加载，禁止全量
+        if (result.task) {
+            const ctx = await taskContext.load(result.task.task_id);
+            const changedFiles = ctx?.execution?.changed_files;
+            if (changedFiles && changedFiles.length > 0) {
+                const anchors = await loadRelevantAnchors({ file_paths: changedFiles });
+                if (anchors && anchors.length > 0) {
+                    result.cognitive_anchors = anchors;
+                }
+            }
+        }
+        // JobManager advisory: 查询活跃 jobs
+        try {
+            const jm = new (await lazyJob()).JobManager(taskContext.getStateDir());
+            const activeJobs = await jm.listActiveJobs();
+            if (activeJobs.length > 0) {
+                result.active_jobs = activeJobs.map((j) => ({
+                    job_id: j.job_id,
+                    task_id: j.task_id,
+                    phase: j.current_phase,
+                    is_alive: j.is_alive,
+                    latest_anchor_summary: j.latest_anchor?.summary,
+                    checkpoint_count: j.checkpoint_count,
+                }));
+            }
+        }
+        catch {
+            // JobManager advisory — 忽略错误
+        }
+        return {
+            result: result,
+        };
+    });
+    // ── sf_audit_sample: 从审计池按风险加权抽样生成抽检清单 ──
+    const AuditSampleSchema = {
+        seed: z.number().optional().describe("抽样种子（默认 0，同种子可复现）"),
+    };
+    registerSafeTool("sf_audit_sample", "从审计池按风险加权抽样，生成抽检清单（SamplingDecision 列表）。只读，不落盘，不生成逃逸报告，不改能力状态", AuditSampleSchema, async (args) => {
+        const stateDir = taskContext.getStateDir();
+        const pool = new (await lazyAuditPool()).AuditPool(stateDir);
+        const items = pool.list();
+        const seed = args.seed ?? 0;
+        const result = (await lazyAuditSampler()).sampleAuditItems(items, seed);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_escape_report: 记录逃逸/误伤/工具故障报告 ──
+    const EscapeReportSchema = {
+        escape_id: z.string().describe("逃逸报告唯一 ID"),
+        task_id: z.string().describe("关联任务 ID"),
+        policy_id: z.string().describe("关联能力 policy ID"),
+        failure_type: z.enum(["rule_gap", "weak_test", "bad_evidence", "ai_escape", "human_miss", "tool_bug", "false_positive"]).describe("失败类型"),
+        expected_guard: z.string().describe("期望的守卫行为"),
+        actual_escape: z.string().describe("实际的逃逸行为"),
+        evidence: z.string().describe("证据"),
+        root_cause: z.string().describe("根因分析"),
+        fix_required: z.string().describe("修复要求"),
+        owner: z.string().describe("负责人"),
+        due_date: z.string().describe("修复截止日期"),
+        capability_action: z.enum(["keep", "downgrade", "disable", "promote_blocked"]).describe("建议的能力动作"),
+        created_at: z.string().optional().describe("报告时间（ISO，默认当前时间）"),
+    };
+    registerSafeTool("sf_escape_report", "记录逃逸、误伤或工具故障报告。只落盘记录，不自动降级，不改能力状态", EscapeReportSchema, async (args) => {
+        const stateDir = taskContext.getStateDir();
+        const store = new (await lazyEscape()).EscapeReportStore(stateDir);
+        const report = {
+            escape_id: args.escape_id,
+            task_id: args.task_id,
+            policy_id: args.policy_id,
+            failure_type: args.failure_type,
+            expected_guard: args.expected_guard,
+            actual_escape: args.actual_escape,
+            evidence: args.evidence,
+            root_cause: args.root_cause,
+            fix_required: args.fix_required,
+            owner: args.owner,
+            due_date: args.due_date,
+            capability_action: args.capability_action,
+            created_at: args.created_at ?? new Date().toISOString(),
+        };
+        store.append(report);
+        return {
+            result: { recorded: true, escape_id: report.escape_id },
+        };
+    });
+    // ── sf_capability_update: 根据复盘结果更新 Capability Registry ──
+    const CapabilityUpdateSchema = {
+        policy_id: z.string().describe("要更新的 policy ID（如 CAP-003）"),
+        target_state: z.enum(["enforced", "advisory", "experimental", "removed"]).describe("目标状态"),
+        reason: z.string().describe("变更原因"),
+        evidence_ids: z.array(z.string()).describe("支撑此变更的 escape report ID 列表"),
+        confirmed_by: z.string().describe("人工确认者标识（如操作者名字）"),
+        dry_run: z.boolean().optional().describe("dry_run 模式：只校验不持久化（默认 false）"),
+        confirm: z.boolean().describe("人工确认标志，必须为 true 才能执行变更"),
+    };
+    registerSafeTool("sf_capability_update", "根据复盘结果更新 Capability Registry 状态。支持 dry_run 校验、证据校验、人工确认。不会自动触发，必须显式调用", CapabilityUpdateSchema, async (args) => {
+        const stateDir = taskContext.getStateDir();
+        const escapeStore = new (await lazyEscape()).EscapeReportStore(stateDir);
+        const stateStore = new (await lazyCapState()).CapabilityStateStore(stateDir);
+        const escapeReports = escapeStore.list();
+        const capabilities = (await lazyCapability()).getAllCapabilities();
+        const cap = capabilities.find((c) => c.policy_id === args.policy_id);
+        const currentState = stateStore.getEffectiveState(args.policy_id, cap?.state ?? "experimental");
+        const result = stateStore.apply({
+            policy_id: args.policy_id,
+            target_state: args.target_state,
+            reason: args.reason,
+            evidence_ids: args.evidence_ids,
+            confirmed_by: args.confirmed_by,
+            dry_run: args.dry_run ?? false,
+            confirm: args.confirm,
+        }, currentState, cap?.id ?? null, escapeReports);
+        return {
+            result: result,
+        };
+    });
+    // ── sf_governance_report: 治理健康报告 ──
+    const GovernanceReportSchema = {
+        seed: z.number().optional().describe("抽样种子（用于计算 sampled_count，默认 0）"),
+    };
+    registerSafeTool("sf_governance_report", "生成治理健康报告：汇总审计池、逃逸报告、能力动作决策。只读，不改状态", GovernanceReportSchema, async (args) => {
+        const stateDir = taskContext.getStateDir();
+        const seed = args.seed ?? 0;
+        const pool = new (await lazyAuditPool()).AuditPool(stateDir);
+        const escapeStore = new (await lazyEscape()).EscapeReportStore(stateDir);
+        const auditItems = pool.list();
+        const auditStats = pool.stats();
+        const escapeReports = escapeStore.list();
+        const escapeStats = escapeStore.stats();
+        // 为所有能力生成动作决策（使用有效状态）
+        const capabilities = (await lazyCapability()).getAllCapabilities();
+        const stateStore = new (await lazyCapState()).CapabilityStateStore(stateDir);
+        const decisions = await Promise.all(capabilities.map(async (cap) => {
+            const effectiveState = stateStore.getEffectiveState(cap.policy_id, cap.state);
+            return (await lazyCapAdvisor()).decideAction(escapeReports, effectiveState, cap.policy_id);
+        }));
+        // 为 sampled_count 生成抽样决策
+        const sampleResult = (await lazyAuditSampler()).sampleAuditItems(auditItems, seed);
+        // 双层机制发现
+        const dlFindings = (await lazyDualLayer()).validateMechanismLayerMaps();
+        const dlMechanismCount = (await lazyDualLayer()).listMechanismLayerMaps().length;
+        // 收集近期任务的产物记录
+        const recentTasks = await taskContext.listRecent(20);
+        const artifacts = [];
+        for (const t of recentTasks) {
+            const tCtx = await taskContext.load(t.task_id);
+            if (tCtx?.artifact_output)
+                artifacts.push(tCtx.artifact_output);
+        }
+        // 收集配置解析报告 — 使用共享函数获取真实数据
+        let configReports = [];
+        let configEntries = [];
+        try {
+            const resolved = await (await lazyConfigPrecedence()).resolveCurrentProjectConfigReports(projectPath);
+            configReports = resolved.reports;
+            configEntries = resolved.entries;
+        }
+        catch (e) {
+            internalWarn("配置报告", "解析失败:", e instanceof Error ? e.message : String(e));
+        }
+        // 同时包含近期任务上下文中的报告
+        for (const t of recentTasks) {
+            const tCtx = await taskContext.load(t.task_id);
+            if (tCtx?.expansion?.config_resolution_reports) {
+                configReports.push(...tCtx.expansion.config_resolution_reports);
+            }
+        }
+        const report = (await lazyGovernance()).generateReport(auditStats, auditItems, escapeReports, escapeStats, decisions, new Date(), sampleResult.decisions, dlFindings, dlMechanismCount, artifacts.length > 0 ? artifacts : undefined, configReports.length > 0 ? configReports : undefined, configEntries.length > 0 ? configEntries : undefined);
+        return {
+            result: report,
+        };
+    });
+    // ── sf_audit_integration: 主链路集成审计 ──
+    const AuditIntegrationSchema = {
+        changed_files: z.array(z.string()).optional().describe("只审计指定的变更文件列表"),
+        json_output: z.boolean().optional().describe("以 JSON 格式输出（默认为人类可读文本）"),
+    };
+    registerSafeTool("sf_audit_integration", "审计生产代码的主链路集成状态，检测孤岛模块（只被测试导入、无生产代码调用的模块）", AuditIntegrationSchema, async (args) => {
+        const projectPath = config._projectPath || process.cwd();
+        // 使用作用域感知的生产文件收集（支持多仓库、多语言）
+        const { collectAllProductionFiles } = await import("../../../engine/audit/main_path_integration_contract.js");
+        const allProdFiles = collectAllProductionFiles(projectPath, config);
+        if (allProdFiles.length === 0) {
+            return {
+                result: { error: "未找到生产源文件" },
+            };
+        }
+        const targetFiles = args.changed_files
+            ? allProdFiles.filter((rel) => args.changed_files.some((cf) => rel === cf || rel.startsWith(cf.replace(/\.(ts|tsx|js|jsx|java|kt|go|py)$/, ""))))
+            : allProdFiles;
+        const contracts = (await lazyMainPath()).buildMainPathIntegrationContracts(projectPath, targetFiles, config);
+        const report = (await lazyMainPath()).auditIntegration(contracts);
+        if (args.json_output) {
+            return {
+                result: report,
+            };
+        }
+        const lines = [];
+        lines.push("主链路集成审计报告");
+        lines.push(`受检模块: ${targetFiles.length} | 孤岛: ${report.orphan_modules.length} | 仅测试: ${report.test_only_modules.length} | 仅注册: ${report.registry_only_modules.length}`);
+        lines.push("");
+        for (const finding of report.findings) {
+            const icon = finding.severity === "hard_fail" ? "X" : finding.severity === "warning" ? "~" : "i";
+            lines.push(`${icon} ${finding.module_path}: ${finding.reason}`);
+            if (finding.recommended_action) {
+                lines.push(`  -> ${finding.recommended_action}`);
+            }
+        }
+        if (report.findings.length === 0) {
+            lines.push("所有受检模块已通过集成检查。");
+        }
+        return {
+            result: { text: lines.join("\n") },
+        };
+    });
+    // ── sf_navigation: 工作流导航 — 问题六十五 ──
+    const NavigationSchema = {
+        project_path: z.string().optional().describe("项目路径（可选，默认当前目录）"),
+    };
+    registerSafeTool("sf_navigation", "查询工作流导航: 当前项目阶段、任务阶段、下一步操作和禁止操作。用于\"下一步\"\"继续\"\"现在能写代码吗\"等模糊推进意图。不得靠模型经验回答，必须调用此工具获取真实导航状态", NavigationSchema, async (args) => {
+        const projectPath = args.project_path || config._projectPath || process.cwd();
+        const { planNextAction } = await import("../../../engine/workflow/next_action_planner.js");
+        const plan = await planNextAction(projectPath);
+        return {
+            result: {
+                project_stage: plan.project_stage,
+                task_stage: plan.task_stage,
+                current_task_id: plan.current_task_id,
+                confidence: plan.confidence,
+                stage_evidence: plan.stage_evidence,
+                blocking_reasons: plan.blocking_reasons,
+                stale_task: plan.stale_task,
+                confirmation_decisions: plan.confirmation_decisions,
+                work_package: plan.work_package ? {
+                    id: plan.work_package.id,
+                    goal_zh: plan.work_package.goal_zh,
+                    description_zh: plan.work_package.description_zh,
+                    action: plan.work_package.action,
+                    tool_name: plan.work_package.tool_name,
+                    must_read: plan.work_package.must_read,
+                    forbidden_changes: plan.work_package.forbidden_changes,
+                    expected_outputs: plan.work_package.expected_outputs,
+                    acceptance_commands: plan.work_package.acceptance_commands,
+                } : null,
+                disallowed_actions: plan.disallowed_actions,
+                recommended_commands: plan.recommended_commands,
+                recommended_prompt_zh: plan.recommended_prompt_zh,
+            },
+        };
+    });
+}
+//# sourceMappingURL=admin.js.map