@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/mcp-schema-audit.js

@@ -1,773 +1 @@
-import * as fs from 'fs';
-import * as path from 'path';
-export const DEPLOYED_TOOLS_DIR = 'c:\\Users\\zhou\\.trae-cn\\mcps\\s_wowok-7838e181\\solo_agent\\mcp_wagent\\tools';
-export const GENERATED_SCHEMAS_DIR = 'd:\\wowok\\agent\\mcp\\dist\\schemas';
-export const MCP_SRC_SCHEMA_DIR = 'd:\\wowok\\agent\\mcp\\src\\schema';
-export const MCP_SRC_TOOLS_DIR = 'd:\\wowok\\agent\\mcp\\src\\tools';
-export const GENERATION_SCRIPT = 'd:\\wowok\\agent\\mcp\\scripts\\generate-json-schemas.ts';
-export const TOOLS_INDEX_FILE = 'd:\\wowok\\agent\\mcp\\src\\tools\\index.ts';
-export const MCP_SCHEMA_AUDIT_VERSION = '1.0.0';
-export const TOOLS_17 = [
-    { name: 'onchain_operations', input_schema_export: 'OnchainOperationsSchema', output_schema_export: 'CallOutputSchema' },
-    { name: 'account_operation', input_schema_export: 'AccountOperationSchema', output_schema_export: 'AccountOperationOutputWrappedSchema' },
-    { name: 'local_mark_operation', input_schema_export: 'LocalMarkOperationSchema', output_schema_export: 'LocalMarkOperationOutputWrappedSchema' },
-    { name: 'local_info_operation', input_schema_export: 'LocalInfoOperationSchema', output_schema_export: 'LocalInfoOperationOutputWrappedSchema' },
-    { name: 'wip_file', input_schema_export: 'WipOperationsSchema', output_schema_export: 'WipOperationOutputSchema' },
-    { name: 'messenger_operation', input_schema_export: 'MessengerOperationInputSchema', output_schema_export: 'MessengerOperationOutputSchema' },
-    { name: 'guard2file', input_schema_export: 'Guard2File_InputSchema', output_schema_export: 'Guard2File_OutputWrappedSchema' },
-    { name: 'machineNode2file', input_schema_export: 'MachineNode2File_InputSchema', output_schema_export: 'MachineNode2File_OutputWrappedSchema' },
-    { name: 'query_toolkit', input_schema_export: 'WatchQueryOperationsSchema', output_schema_export: 'WatchQueryOperationsResultSchema' },
-    { name: 'onchain_table_data', input_schema_export: 'OnchainTableDataSchema', output_schema_export: 'OnchainTableDataResultSchema' },
-    { name: 'onchain_events', input_schema_export: 'OnchainEventsInputSchema', output_schema_export: 'OnchainEventsResultSchema' },
-    { name: 'wowok_buildin_info', input_schema_export: 'ProtocolInfoQuerySchema', output_schema_export: 'ProtocolInfoResultSchema' },
-    { name: 'schema_query', input_schema_export: 'SchemaQueryInputSchema', output_schema_export: 'SchemaQueryOutputSchema' },
-    { name: 'bridge_operation', input_schema_export: 'BridgeOperationsSchema', output_schema_export: 'BridgeCallOutputSchema' },
-    { name: 'project_operation', input_schema_export: 'ProjectOperationInputSchema', output_schema_export: 'ProjectOperationOutputSchema' },
-    { name: 'config_operation', input_schema_export: 'ConfigOperationInputSchema', output_schema_export: 'ConfigOperationOutputSchema' },
-    { name: 'trust_score', input_schema_export: 'TrustScoreInputSchema', output_schema_export: 'TrustScoreOutputSchema' },
-];
-export function loadLayer4Deployed(toolName) {
-    const filePath = path.join(DEPLOYED_TOOLS_DIR, `${toolName}.json`);
-    const fallback = {
-        tool_descriptor_file: filePath,
-        file_exists: false,
-        is_stub: true,
-        properties_count: 0,
-        required_count: 0,
-        has_schema_hint: false,
-        has_additional_properties_false: false,
-        has_dollar_schema: false,
-        has_oneof: false,
-        has_anyof: false,
-        has_allof: false,
-        union_count: 0,
-    };
-    if (!fs.existsSync(filePath))
-        return fallback;
-    try {
-        const raw = fs.readFileSync(filePath, 'utf-8');
-        const data = JSON.parse(raw);
-        const args = data.arguments ?? {};
-        const props = args.properties ?? {};
-        const required = args.required ?? [];
-        const propKeys = Object.keys(props);
-        const oneOfArr = args.oneOf ?? [];
-        const anyOfArr = args.anyOf ?? [];
-        const allOfArr = args.allOf ?? [];
-        const hasOneOf = oneOfArr.length > 0;
-        const hasAnyOf = anyOfArr.length > 0;
-        const hasAllOf = allOfArr.length > 0;
-        const unionCount = oneOfArr.length + anyOfArr.length + allOfArr.length;
-        const isStub = propKeys.length === 0 && unionCount === 0;
-        const description = data.description ?? '';
-        const hasSchemaHint = description.includes('schema_query');
-        return {
-            tool_descriptor_file: filePath,
-            file_exists: true,
-            is_stub: isStub,
-            properties_count: propKeys.length,
-            required_count: required.length,
-            has_schema_hint: hasSchemaHint,
-            has_additional_properties_false: args.additionalProperties === false,
-            has_dollar_schema: !!args.$schema,
-            has_oneof: hasOneOf,
-            has_anyof: hasAnyOf,
-            has_allof: hasAllOf,
-            union_count: unionCount,
-        };
-    }
-    catch {
-        return fallback;
-    }
-}
-export function loadLayer3Generated(toolName) {
-    const inputPath = path.join(GENERATED_SCHEMAS_DIR, `${toolName}.schema.json`);
-    const outputPath = path.join(GENERATED_SCHEMAS_DIR, `${toolName}.output.json`);
-    const inputExists = fs.existsSync(inputPath);
-    const outputExists = fs.existsSync(outputPath);
-    const inputSize = inputExists ? fs.statSync(inputPath).size : 0;
-    const outputSize = outputExists ? fs.statSync(outputPath).size : 0;
-    return {
-        input_schema_file: inputPath,
-        output_schema_file: outputPath,
-        input_exists: inputExists,
-        output_exists: outputExists,
-        input_size_bytes: inputSize,
-        output_size_bytes: outputSize,
-    };
-}
-export function analyzeLayerCensus() {
-    const census = [];
-    for (const tool of TOOLS_17) {
-        census.push({
-            name: tool.name,
-            layer2_zod: {
-                input_schema_export: tool.input_schema_export,
-                output_schema_export: tool.output_schema_export,
-                schema_dir: MCP_SRC_SCHEMA_DIR,
-            },
-            layer3_generated: loadLayer3Generated(tool.name),
-            layer4_deployed: loadLayer4Deployed(tool.name) ?? {},
-        });
-    }
-    return census;
-}
-export function analyzeDeployedStubInconsistency(census) {
-    const findings = [];
-    const stubs = [];
-    const fullSchemas = [];
-    for (const c of census) {
-        if (!c.layer4_deployed.file_exists) {
-            findings.push({
-                rule_id: 'MCP-DEPLOY-001',
-                severity: 'critical',
-                category: 'stub_inconsistency',
-                tool_name: c.name,
-                description: `Layer 4 deployed file does not exist: ${c.layer4_deployed.tool_descriptor_file}`,
-                location: c.layer4_deployed.tool_descriptor_file,
-                fix: `Create ${c.name}.json in DEPLOYED_TOOLS_DIR matching the Layer 3 generated schema.`,
-            });
-            continue;
-        }
-        if (c.layer4_deployed.is_stub) {
-            stubs.push(c);
-        }
-        else {
-            fullSchemas.push(c);
-        }
-    }
-    for (const c of stubs) {
-        findings.push({
-            rule_id: 'MCP-STUB-001',
-            severity: 'high',
-            category: 'stub_inconsistency',
-            tool_name: c.name,
-            description: `Layer 4 deployed file is a STUB (empty properties:{}) — LLM must call schema_query(action='get', name='${c.name}') to learn the parameter structure. This is inconsistent with the ${fullSchemas.length} tools that embed full schemas.`,
-            location: c.layer4_deployed.tool_descriptor_file,
-            fix: `Regenerate ${c.name}.json from dist/schemas/${c.name}.schema.json (resolve $ref, inline definitions, wrap as {name, description, arguments}).`,
-        });
-        if (!c.layer4_deployed.has_schema_hint) {
-            findings.push({
-                rule_id: 'MCP-STUB-003',
-                severity: 'high',
-                category: 'stub_inconsistency',
-                tool_name: c.name,
-                description: `Stub file is missing schema_query hint in description — the LLM has no way to discover the parameter structure. Description should mention schema_query(action='get', name='${c.name}').`,
-                location: c.layer4_deployed.tool_descriptor_file,
-                fix: `Add "💡 Schema hint: Use schema_query with action='get' and name='${c.name}' to retrieve the exact parameter schema before calling." to the description.`,
-            });
-        }
-    }
-    if (stubs.length > 0 && fullSchemas.length > 0) {
-        findings.push({
-            rule_id: 'MCP-STUB-002',
-            severity: 'info',
-            category: 'stub_inconsistency',
-            tool_name: '(all)',
-            description: `Layer 4 deployed files are INCONSISTENT: ${stubs.length} stubs + ${fullSchemas.length} full schemas. Stubs: ${stubs.map(s => s.name).join(', ')}. Full: ${fullSchemas.map(s => s.name).join(', ')}.`,
-            fix: `Make all 17 files consistent — either (a) embed full schemas in all 17 (RECOMMENDED — gives LLM immediate access), or (b) keep all stubs and rely on schema_query (increases token cost + latency).`,
-        });
-    }
-    return findings;
-}
-export function analyzeLayerParity(census) {
-    const findings = [];
-    for (const c of census) {
-        if (!c.layer4_deployed.file_exists || c.layer4_deployed.is_stub)
-            continue;
-        if (!c.layer3_generated.input_exists) {
-            findings.push({
-                rule_id: 'MCP-PARITY-001',
-                severity: 'critical',
-                category: 'layer_parity',
-                tool_name: c.name,
-                description: `Layer 4 has full schema but Layer 3 generated file is missing: ${c.layer3_generated.input_schema_file}`,
-                fix: `Run pnpm generate:schemas to regenerate Layer 3 from Zod source.`,
-            });
-            continue;
-        }
-        const l4 = readLayer4Arguments(c.name);
-        const l3 = readLayer3ResolvedSchema(c.name);
-        if (!l4 || !l3)
-            continue;
-        const l4Props = new Set(Object.keys(l4.properties ?? {}));
-        const l3Props = new Set(Object.keys(l3.properties ?? {}));
-        const missingInL4 = [...l3Props].filter(p => !l4Props.has(p));
-        const extraInL4 = [...l4Props].filter(p => !l3Props.has(p));
-        if (missingInL4.length > 0) {
-            findings.push({
-                rule_id: 'MCP-PARITY-002',
-                severity: 'high',
-                category: 'layer_parity',
-                tool_name: c.name,
-                description: `Layer 4 deployed schema is missing ${missingInL4.length} properties present in Layer 3 generated schema: ${missingInL4.join(', ')}`,
-                location: c.layer4_deployed.tool_descriptor_file,
-                fix: `Regenerate ${c.name}.json from dist/schemas/${c.name}.schema.json.`,
-            });
-        }
-        if (extraInL4.length > 0) {
-            findings.push({
-                rule_id: 'MCP-PARITY-003',
-                severity: 'medium',
-                category: 'layer_parity',
-                tool_name: c.name,
-                description: `Layer 4 deployed schema has ${extraInL4.length} extra properties not in Layer 3: ${extraInL4.join(', ')}`,
-                location: c.layer4_deployed.tool_descriptor_file,
-                fix: `Regenerate ${c.name}.json from dist/schemas/${c.name}.schema.json.`,
-            });
-        }
-        const l4Req = new Set(l4.required ?? []);
-        const l3Req = new Set(l3.required ?? []);
-        const reqMissing = [...l3Req].filter(r => !l4Req.has(r));
-        const reqExtra = [...l4Req].filter(r => !l3Req.has(r));
-        if (reqMissing.length > 0 || reqExtra.length > 0) {
-            findings.push({
-                rule_id: 'MCP-PARITY-004',
-                severity: 'high',
-                category: 'layer_parity',
-                tool_name: c.name,
-                description: `Layer 4 'required' array differs from Layer 3. Missing in L4: [${reqMissing.join(', ')}]. Extra in L4: [${reqExtra.join(', ')}].`,
-                location: c.layer4_deployed.tool_descriptor_file,
-                fix: `Sync 'required' array from Layer 3 to Layer 4.`,
-            });
-        }
-        const l4AP = l4.additionalProperties;
-        const l3AP = l3.additionalProperties;
-        if (l4AP !== l3AP) {
-            findings.push({
-                rule_id: 'MCP-PARITY-005',
-                severity: 'medium',
-                category: 'layer_parity',
-                tool_name: c.name,
-                description: `Layer 4 'additionalProperties' (${JSON.stringify(l4AP)}) differs from Layer 3 (${JSON.stringify(l3AP)}).`,
-                location: c.layer4_deployed.tool_descriptor_file,
-                fix: `Sync 'additionalProperties' value.`,
-            });
-        }
-    }
-    return findings;
-}
-function readLayer4Arguments(toolName) {
-    const filePath = path.join(DEPLOYED_TOOLS_DIR, `${toolName}.json`);
-    try {
-        const raw = fs.readFileSync(filePath, 'utf-8');
-        const data = JSON.parse(raw);
-        return data.arguments ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-function readLayer3ResolvedSchema(toolName) {
-    const filePath = path.join(GENERATED_SCHEMAS_DIR, `${toolName}.schema.json`);
-    try {
-        const raw = fs.readFileSync(filePath, 'utf-8');
-        const data = JSON.parse(raw);
-        if (data.$ref && data.$ref.startsWith('#/definitions/')) {
-            const defName = data.$ref.slice('#/definitions/'.length);
-            const def = data.definitions?.[defName];
-            if (def && typeof def === 'object') {
-                return def;
-            }
-        }
-        return data;
-    }
-    catch {
-        return null;
-    }
-}
-export function analyzeAnyUnknownCensus() {
-    const instances = [];
-    const scanDirs = [MCP_SRC_SCHEMA_DIR, MCP_SRC_TOOLS_DIR];
-    for (const dir of scanDirs) {
-        const files = listTypeScriptFiles(dir);
-        for (const file of files) {
-            const lines = fs.readFileSync(file, 'utf-8').split('\n');
-            for (let i = 0; i < lines.length; i++) {
-                const line = lines[i];
-                const trimmed = line.trim();
-                if (trimmed.startsWith('//') || trimmed.startsWith('*'))
-                    continue;
-                const patterns = [
-                    { regex: /z\.any\(\)/g, pattern: 'z.any()' },
-                    { regex: /z\.unknown\(\)/g, pattern: 'z.unknown()' },
-                    { regex: /args\s*:\s*any\b/g, pattern: 'args: any' },
-                    { regex: /Promise\s*<\s*any\s*>/g, pattern: 'Promise<any>' },
-                    { regex: /Record\s*<\s*string\s*,\s*any\s*>/g, pattern: 'Record<string, any>' },
-                    { regex: /\bas\s+any\b/g, pattern: 'as any' },
-                ];
-                for (const { regex, pattern } of patterns) {
-                    regex.lastIndex = 0;
-                    let m;
-                    while ((m = regex.exec(line)) !== null) {
-                        const category = categorizeAnyInstance(file, i + 1, line, pattern);
-                        instances.push({
-                            file,
-                            line: i + 1,
-                            code: trimmed.length > 120 ? trimmed.slice(0, 117) + '...' : trimmed,
-                            pattern,
-                            category: category.category,
-                            reason: category.reason,
-                            fix_suggestion: category.fix,
-                        });
-                    }
-                }
-            }
-        }
-    }
-    return instances;
-}
-function listTypeScriptFiles(dir) {
-    const result = [];
-    if (!fs.existsSync(dir))
-        return result;
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            if (entry.name === '__tests__' || entry.name === 'node_modules')
-                continue;
-            result.push(...listTypeScriptFiles(fullPath));
-        }
-        else if (entry.isFile() && entry.name.endsWith('.ts')) {
-            result.push(fullPath);
-        }
-    }
-    return result;
-}
-function categorizeAnyInstance(file, lineNum, line, pattern) {
-    const fileName = path.basename(file);
-    const trimmed = line.trim();
-    if (pattern === 'z.any()' && /SemanticSummarySchema\s*=\s*z\.any\(\)/.test(trimmed)) {
-        return {
-            category: 'fixable',
-            reason: 'Circular-dependency workaround for SemanticSummarySchema — can use z.lazy() or refactor to break the cycle.',
-            fix: 'Define SemanticSummarySchema with z.lazy(() => SemanticSummarySchemaReal) or restructure imports to break the cycle.',
-        };
-    }
-    if (pattern === 'z.any()' && /result\s*:\s*z\.any\(\)/.test(trimmed) && /[\\/]config[\\/]|[\\/]project[\\/]/.test(file)) {
-        return {
-            category: 'fixable',
-            reason: `Result shape depends on action — can use z.discriminatedUnion('action', [...]) to type each action's result.`,
-            fix: `Define discriminated union: z.discriminatedUnion('action', [z.object({action: z.literal('list'), result: ...}), ...]).`,
-        };
-    }
-    if (pattern === 'z.unknown()' && /result\s*:\s*z\.unknown\(\)/.test(trimmed) && /index\.ts/.test(fileName)) {
-        return {
-            category: 'fixable',
-            reason: 'query_toolkit output result depends on query_type — can use z.discriminatedUnion(\'query_type\', [...]).',
-            fix: 'Define discriminated union: z.discriminatedUnion(\'query_type\', [z.object({query_type: z.literal(\'local_mark_list\'), result: z.array(MarkDataSchema)}), ...]).',
-        };
-    }
-    if (pattern === 'z.any()' && /data\s*:\s*z\.any\(\)/.test(trimmed) && /[\\/]schema-query[\\/]/.test(file)) {
-        return {
-            category: 'fixable',
-            reason: 'SchemaQuery output data depends on action — can use discriminated union by action.',
-            fix: 'Define discriminated union: action=\'get\' returns JSON Schema, action=\'list\' returns array of items.',
-        };
-    }
-    if (pattern === 'args: any' && /handlers[\\/]/.test(file)) {
-        return {
-            category: 'fixable',
-            reason: 'Handler args can use `unknown` (forces runtime validation) or a typed input schema.',
-            fix: 'Replace `args: any` with `args: unknown` and use strictParse(schema, args) at the top of the handler.',
-        };
-    }
-    if (pattern === 'args: any' && /tools[\\/]index\.ts/.test(file)) {
-        return {
-            category: 'fixable',
-            reason: 'dispatchToolCall args is `any` — can be `unknown` since each tool parses with its own schema.',
-            fix: 'Change `args: any` to `args: unknown` in dispatchToolCall signature.',
-        };
-    }
-    if (pattern === 'args: any' && /types\.ts/.test(fileName) && /handler/.test(trimmed)) {
-        return {
-            category: 'fixable',
-            reason: 'ToolEntry.handler args is `any` — can be `unknown` (each handler parses with its own schema).',
-            fix: 'Change `handler: (args: any) => ...` to `handler: (args: unknown) => ...`.',
-        };
-    }
-    if (pattern === 'z.any()' && /claimReceipt|ethReceipt|wowReceipt/.test(trimmed)) {
-        return {
-            category: 'legitimate',
-            reason: 'EVM transaction receipts have an externally-defined shape from viem/ethers — z.any() is acceptable (receipt is informational, not validated).',
-        };
-    }
-    if (pattern === 'z.any()' && /content_raw/.test(trimmed)) {
-        return {
-            category: 'legitimate',
-            reason: 'content_raw holds raw content for unknown object types — by definition untyped. z.any() is acceptable here.',
-        };
-    }
-    if ((pattern === 'z.unknown()' || pattern === 'z.any()') && /parsedJson/.test(trimmed)) {
-        return {
-            category: 'legitimate',
-            reason: 'Event parsedJson is arbitrary on-chain event data — z.record(z.string(), z.unknown()) is appropriate.',
-        };
-    }
-    if (pattern === 'z.any()' && /key_value/.test(trimmed)) {
-        return {
-            category: 'fixable',
-            reason: 'Repository key_value depends on key_type — could use discriminated union by key_type (string→z.string(), u64→z.bigint()/number, etc.).',
-            fix: 'Define z.discriminatedUnion(\'key_type\', [...]) with each variant typed.',
-        };
-    }
-    if (pattern === 'z.unknown()' && /data\s*:\s*z\.unknown\(\)/.test(trimmed) && /[\\/]bridge/.test(file)) {
-        return {
-            category: 'legitimate',
-            reason: 'Bridge operation result data varies by operation_type — currently 9 different shapes. Discriminated union would be ideal but high refactor cost.',
-        };
-    }
-    if (pattern === 'z.unknown()' && /adjusted_params/.test(trimmed)) {
-        return {
-            category: 'legitimate',
-            reason: 'adjusted_params are free-form key-value pairs suggested by AI — z.record(z.string(), z.unknown()) is appropriate.',
-        };
-    }
-    if (pattern === 'z.any()' && /object\s*:\s*z\.union.*z\.record\(z\.any\(\)/.test(trimmed)) {
-        return {
-            category: 'fixable',
-            reason: 'Creation vs reference object union — z.record(z.any()) should be replaced with NamedObjectSchema (structured creation input).',
-            fix: 'Replace z.record(z.any()) with NamedObjectSchema (already defined in base.ts).',
-        };
-    }
-    if (pattern === 'z.any()' && /result\s*:\s*z\.any\(\)\.optional\(\)/.test(trimmed) && /[\\/]bridge/.test(file)) {
-        return {
-            category: 'legitimate',
-            reason: 'Bridge result is operation-specific (manage_evm_rpc has different result per operation) — z.any().optional() is acceptable here.',
-        };
-    }
-    if (pattern === 'Promise<any>' && /[\\/](wrap|shared)\.ts/.test(file)) {
-        return {
-            category: 'fixable',
-            reason: 'Generic wrappers in wrap.ts/shared.ts use Promise<any> — could be made generic <T>.',
-            fix: 'Replace `Promise<any>` with `Promise<ToolDispatchResult>` (the actual return shape).',
-        };
-    }
-    if (pattern === 'Record<string, any>' && /types\.ts/.test(fileName) && /_meta|structuredContent/.test(trimmed)) {
-        return {
-            category: 'fixable',
-            reason: 'ToolConfig._meta and ToolDispatchResult.structuredContent could use structured types.',
-            fix: 'Define ToolMeta interface (category, tags) and replace structuredContent: any with structured type.',
-        };
-    }
-    if (pattern === 'as any') {
-        return {
-            category: 'legitimate',
-            reason: '`as any` cast — usually for third-party type mismatches (MCP SDK). Acceptable if isolated.',
-        };
-    }
-    return {
-        category: 'legitimate',
-        reason: 'Unclassified any/unknown usage — review manually. Defaulting to legitimate (no auto-fix).',
-    };
-}
-export function analyzeHandlerTypeSafety(instances) {
-    const findings = [];
-    for (const inst of instances) {
-        if (inst.pattern !== 'args: any')
-            continue;
-        if (!/tools[\\/]/.test(inst.file))
-            continue;
-        findings.push({
-            rule_id: 'MCP-HANDLER-001',
-            severity: 'medium',
-            category: 'handler_types',
-            tool_name: path.basename(inst.file, '.ts'),
-            description: `Handler uses \`args: any\` — bypasses TypeScript type checking. ${inst.reason}`,
-            location: `${inst.file}:${inst.line}`,
-            fix: inst.fix_suggestion,
-        });
-    }
-    return findings;
-}
-export function analyzeOutputSchemaCoverage(census) {
-    const findings = [];
-    for (const c of census) {
-        if (!c.layer3_generated.output_exists && c.name !== "onchain_operations") {
-            findings.push({
-                rule_id: 'MCP-OUTPUT-001',
-                severity: 'high',
-                category: 'output_coverage',
-                tool_name: c.name,
-                description: `Layer 3 output schema file does not exist: ${c.layer3_generated.output_schema_file}`,
-                fix: `Add outputSchema to ${c.name}'s tool definition and regenerate schemas.`,
-            });
-        }
-        if (c.layer2_zod.output_schema_export === null) {
-            findings.push({
-                rule_id: 'MCP-OUTPUT-002',
-                severity: 'medium',
-                category: 'output_coverage',
-                tool_name: c.name,
-                description: `Layer 2 outputSchema is defined inline (not exported with a stable name). This makes it harder to reference from tests.`,
-                fix: `Export the outputSchema with a stable name (e.g., ${c.name}OutputSchema).`,
-            });
-        }
-    }
-    return findings;
-}
-export function analyzeGenerationScriptSync() {
-    const findings = [];
-    if (!fs.existsSync(GENERATION_SCRIPT)) {
-        findings.push({
-            rule_id: 'MCP-GENSYNC-001',
-            severity: 'critical',
-            category: 'generation_sync',
-            tool_name: '(all)',
-            description: `Generation script not found: ${GENERATION_SCRIPT}`,
-        });
-        return findings;
-    }
-    const src = fs.readFileSync(GENERATION_SCRIPT, 'utf-8');
-    const nameRegex = /name:\s*["']([^"']+)["']/g;
-    const scriptNames = new Set();
-    let m;
-    while ((m = nameRegex.exec(src)) !== null) {
-        if (TOOLS_17.some(t => t.name === m[1])) {
-            scriptNames.add(m[1]);
-        }
-    }
-    for (const tool of TOOLS_17) {
-        if (!scriptNames.has(tool.name)) {
-            findings.push({
-                rule_id: 'MCP-GENSYNC-002',
-                severity: 'high',
-                category: 'generation_sync',
-                tool_name: tool.name,
-                description: `Tool "${tool.name}" is in TOOL_REGISTRY but missing from generate-json-schemas.ts. Layer 3 schemas will not be generated.`,
-                location: GENERATION_SCRIPT,
-                fix: `Add a get${toPascalCase(tool.name)}Tool() function and add it to the tools array.`,
-            });
-        }
-    }
-    return findings;
-}
-function toPascalCase(s) {
-    return s.split('_').map(p => p.charAt(0).toUpperCase() + p.slice(1).toLowerCase()).join('');
-}
-export function analyzeSchemaQueryReflection(census) {
-    const findings = [];
-    for (const c of census) {
-        if (!c.layer3_generated.input_exists) {
-            findings.push({
-                rule_id: 'MCP-REFLECT-001',
-                severity: 'high',
-                category: 'reflection',
-                tool_name: c.name,
-                description: `schema_query(action='get', name='${c.name}') would fail — Layer 3 input schema missing.`,
-                fix: `Run pnpm generate:schemas.`,
-            });
-        }
-        if (!c.layer3_generated.output_exists && c.name !== "onchain_operations") {
-            findings.push({
-                rule_id: 'MCP-REFLECT-002',
-                severity: 'medium',
-                category: 'reflection',
-                tool_name: c.name,
-                description: `schema_query(action='get_output', name='${c.name}') would fail — Layer 3 output schema missing.`,
-                fix: `Run pnpm generate:schemas.`,
-            });
-        }
-    }
-    const onchainOps = [
-        'permission', 'service', 'machine', 'progress', 'guard',
-        'arbitration', 'repository', 'contact', 'treasury', 'reward',
-        'allocation', 'personal', 'payment', 'demand', 'order', 'gen_passport',
-        'proof', 'gen_proof',
-    ];
-    for (const op of onchainOps) {
-        const opFile = path.join(GENERATED_SCHEMAS_DIR, `onchain_operations_${op}.schema.json`);
-        if (!fs.existsSync(opFile)) {
-            findings.push({
-                rule_id: 'MCP-REFLECT-003',
-                severity: 'medium',
-                category: 'reflection',
-                tool_name: `onchain_operations_${op}`,
-                description: `Individual operation schema missing: ${opFile}. schema_query(action='get', name='onchain_operations_${op}') would fail.`,
-                fix: `Run pnpm generate:schemas.`,
-            });
-        }
-    }
-    return findings;
-}
-export function scanAllMcpSchemas() {
-    const census = analyzeLayerCensus();
-    const anyInstances = analyzeAnyUnknownCensus();
-    const findings = [
-        ...analyzeDeployedStubInconsistency(census),
-        ...analyzeLayerParity(census),
-        ...analyzeHandlerTypeSafety(anyInstances),
-        ...analyzeOutputSchemaCoverage(census),
-        ...analyzeGenerationScriptSync(),
-        ...analyzeSchemaQueryReflection(census),
-    ];
-    const bySev = new Map();
-    const byCat = new Map();
-    for (const f of findings) {
-        if (!bySev.has(f.severity))
-            bySev.set(f.severity, []);
-        bySev.get(f.severity).push(f);
-        if (!byCat.has(f.category))
-            byCat.set(f.category, []);
-        byCat.get(f.category).push(f);
-    }
-    const fixable = anyInstances.filter(i => i.category === 'fixable').length;
-    const legit = anyInstances.filter(i => i.category === 'legitimate').length;
-    const external = anyInstances.filter(i => i.category === 'external').length;
-    const stubCount = census.filter(c => c.layer4_deployed.is_stub).length;
-    const fullCount = census.filter(c => !c.layer4_deployed.is_stub && c.layer4_deployed.file_exists).length;
-    return {
-        census,
-        findings,
-        any_unknown_instances: anyInstances,
-        findings_by_severity: bySev,
-        findings_by_category: byCat,
-        total_findings: findings.length,
-        fixable_any_count: fixable,
-        legitimate_any_count: legit,
-        external_any_count: external,
-        stub_count: stubCount,
-        full_schema_count: fullCount,
-    };
-}
-export function formatAuditReport(result) {
-    const lines = [];
-    lines.push(`# MCP Schema Audit Report — 17 WoWok Tools`);
-    lines.push('');
-    lines.push(`> Auto-generated by \`mcp-schema-audit.ts\` v${MCP_SCHEMA_AUDIT_VERSION} — comprehensive`);
-    lines.push(`> 4-layer audit of schema consistency, any/unknown usage, and I/O coverage.`);
-    lines.push('');
-    lines.push(`## Summary`);
-    lines.push('');
-    lines.push(`- **Tools audited**: ${result.census.length}`);
-    lines.push(`- **Total findings**: ${result.total_findings}`);
-    lines.push(`- **Stub files**: ${result.stub_count} / ${result.census.length}`);
-    lines.push(`- **Full schema files**: ${result.full_schema_count} / ${result.census.length}`);
-    lines.push(`- **any/unknown instances**: ${result.any_unknown_instances.length} total`);
-    lines.push(`  - Fixable: ${result.fixable_any_count}`);
-    lines.push(`  - Legitimate: ${result.legitimate_any_count}`);
-    lines.push(`  - External: ${result.external_any_count}`);
-    lines.push('');
-    lines.push(`### Findings by Severity`);
-    lines.push('');
-    lines.push(`| Severity | Count |`);
-    lines.push(`|----------|-------|`);
-    for (const sev of ['critical', 'high', 'medium', 'low', 'info']) {
-        const arr = result.findings_by_severity.get(sev) ?? [];
-        lines.push(`| ${sev} | ${arr.length} |`);
-    }
-    lines.push('');
-    lines.push(`### Findings by Category`);
-    lines.push('');
-    lines.push(`| Category | Count |`);
-    lines.push(`|----------|-------|`);
-    for (const cat of ['stub_inconsistency', 'layer_parity', 'handler_types', 'output_coverage', 'generation_sync', 'reflection']) {
-        const arr = result.findings_by_category.get(cat) ?? [];
-        lines.push(`| ${cat} | ${arr.length} |`);
-    }
-    lines.push('');
-    lines.push(`## Layer Census — All 17 Tools`);
-    lines.push('');
-    lines.push(`| Tool | L3 Input | L3 Output | L4 Status | L4 Properties | L4 Required |`);
-    lines.push(`|------|----------|-----------|-----------|---------------|-------------|`);
-    for (const c of result.census) {
-        const l3i = c.layer3_generated.input_exists ? `✓ ${(c.layer3_generated.input_size_bytes / 1024).toFixed(1)}KB` : '✗ MISSING';
-        const l3o = c.layer3_generated.output_exists ? `✓ ${(c.layer3_generated.output_size_bytes / 1024).toFixed(1)}KB` : '✗ MISSING';
-        const l4s = !c.layer4_deployed.file_exists ? '✗ MISSING' : c.layer4_deployed.is_stub ? '⚠ STUB' : '✓ FULL';
-        const l4p = c.layer4_deployed.properties_count;
-        const l4r = c.layer4_deployed.required_count;
-        lines.push(`| ${c.name} | ${l3i} | ${l3o} | ${l4s} | ${l4p} | ${l4r} |`);
-    }
-    lines.push('');
-    lines.push(`## Findings Detail`);
-    lines.push('');
-    const orderedSeverities = ['critical', 'high', 'medium', 'low', 'info'];
-    for (const sev of orderedSeverities) {
-        const sevFindings = result.findings_by_severity.get(sev) ?? [];
-        if (sevFindings.length === 0)
-            continue;
-        const title = sev.toUpperCase();
-        lines.push(`### ${title} (${sevFindings.length})`);
-        lines.push('');
-        for (const f of sevFindings) {
-            lines.push(`- **[${f.rule_id}] ${f.description}`);
-            if (f.location)
-                lines.push(`  - Location: \`${f.location}\``);
-            if (f.fix)
-                lines.push(`  - Fix: ${f.fix}`);
-            lines.push('');
-        }
-    }
-    lines.push(`## any/unknown Census Detail`);
-    lines.push('');
-    lines.push(`Total instances: ${result.any_unknown_instances.length}`);
-    lines.push('');
-    lines.push(`### By Pattern`);
-    lines.push('');
-    lines.push(`| Pattern | Total | Fixable | Legitimate | External |`);
-    lines.push(`|---------|-------|---------|------------|----------|`);
-    const patternGroups = new Map();
-    for (const inst of result.any_unknown_instances) {
-        if (!patternGroups.has(inst.pattern))
-            patternGroups.set(inst.pattern, []);
-        patternGroups.get(inst.pattern).push(inst);
-    }
-    for (const [pattern, arr] of [...patternGroups.entries()].sort((a, b) => b[1].length - a[1].length)) {
-        const fixable = arr.filter(i => i.category === 'fixable').length;
-        const legit = arr.filter(i => i.category === 'legitimate').length;
-        const ext = arr.filter(i => i.category === 'external').length;
-        lines.push(`| \`${pattern}\` | ${arr.length} | ${fixable} | ${legit} | ${ext} |`);
-    }
-    lines.push('');
-    const fixable = result.any_unknown_instances.filter(i => i.category === 'fixable');
-    if (fixable.length > 0) {
-        lines.push(`### Fixable Instances (Priority List)`);
-        lines.push('');
-        for (const inst of fixable) {
-            lines.push(`- **${path.basename(inst.file)}:${inst.line}** [\`${inst.pattern}\`]`);
-            lines.push(`  - Code: \`${inst.code}\``);
-            lines.push(`  - Reason: ${inst.reason}`);
-            if (inst.fix_suggestion)
-                lines.push(`  - Fix: ${inst.fix_suggestion}`);
-            lines.push('');
-        }
-    }
-    lines.push(`## Recommended Action Plan`);
-    lines.push('');
-    lines.push(`### Phase 1: Fix Layer 4 Stub Inconsistency (CRITICAL UX)`);
-    lines.push('');
-    lines.push(`The ${result.stub_count} stub files force the LLM to call \`schema_query\` first, creating an extra round-trip. Fix by regenerating all 17 Layer 4 files from Layer 3 schemas:`);
-    lines.push('');
-    lines.push(`\`\`\`bash`);
-    lines.push(`# 1. Generate Layer 3 schemas from Zod source`);
-    lines.push(`cd d:/wowok/agent/mcp && pnpm generate:schemas`);
-    lines.push('');
-    lines.push(`# 2. Generate Layer 4 deployed files from Layer 3`);
-    lines.push(`# (Run the new sync-deployed-tools.ts script — see E2.4)`);
-    lines.push(`npx tsx scripts/sync-deployed-tools.ts`);
-    lines.push(`\`\`\``);
-    lines.push('');
-    lines.push(`### Phase 2: Type the ${result.fixable_any_count} fixable any/unknown instances`);
-    lines.push('');
-    lines.push(`Priority order:`);
-    lines.push('');
-    lines.push(`1. **SemanticSummarySchema** (src/schema/local/index.ts:6) — use \`z.lazy()\``);
-    lines.push(`2. **ConfigOperationOutputSchema.result** (src/schema/config/index.ts:17) — discriminated union by action`);
-    lines.push(`3. **ProjectOperationOutputSchema.result** (src/schema/project/index.ts:34) — discriminated union by action`);
-    lines.push(`4. **query_toolkit output result** (src/tools/index.ts:250) — discriminated union by query_type`);
-    lines.push(`5. **SchemaQueryOutputSchema.data** (src/schema/schema-query/index.ts:34) — discriminated union by action`);
-    lines.push(`6. **RepositoryKeyValueSchema.key_value** (src/schema/operations.ts:331) — discriminated union by key_type`);
-    lines.push(`7. **Handler args: any** — replace with \`unknown\` (forces strictParse at top of handler)`);
-    lines.push(`8. **dispatchToolCall(name, args: any)** — replace with \`unknown\``);
-    lines.push('');
-    lines.push(`### Phase 3: Verify I/O Schema Match`);
-    lines.push('');
-    lines.push(`For each tool, write a parity test that:`);
-    lines.push(`1. Calls the handler with a minimal valid input`);
-    lines.push(`2. Captures the structuredContent`);
-    lines.push(`3. Validates structuredContent against outputSchema`);
-    lines.push(`4. Reports any mismatch`);
-    lines.push('');
-    return lines.join('\n');
-}
+import*as a116a from'fs';import*as a116b from'path';export const DEPLOYED_TOOLS_DIR='c:\x5cUsers\x5czhou\x5c.trae-cn\x5cmcps\x5cs_wowok-7838e181\x5csolo_agent\x5cmcp_wagent\x5ctools';export const GENERATED_SCHEMAS_DIR='d:\x5cwowok\x5cagent\x5cmcp\x5cdist\x5cschemas';export const MCP_SRC_SCHEMA_DIR='d:\x5cwowok\x5cagent\x5cmcp\x5csrc\x5cschema';export const MCP_SRC_TOOLS_DIR='d:\x5cwowok\x5cagent\x5cmcp\x5csrc\x5ctools';export const GENERATION_SCRIPT='d:\x5cwowok\x5cagent\x5cmcp\x5cscripts\x5cgenerate-json-schemas.ts';export const TOOLS_INDEX_FILE='d:\x5cwowok\x5cagent\x5cmcp\x5csrc\x5ctools\x5cindex.ts';export const MCP_SCHEMA_AUDIT_VERSION='1.0.0';export const ALL_TOOLS=[{'name':'onchain_operations','input_schema_export':'OnchainOperationsSchema','output_schema_export':'CallOutputSchema'},{'name':'account_operation','input_schema_export':'AccountOperationSchema','output_schema_export':'AccountOperationOutputWrappedSchema'},{'name':'local_mark_operation','input_schema_export':'LocalMarkOperationSchema','output_schema_export':'LocalMarkOperationOutputWrappedSchema'},{'name':'local_info_operation','input_schema_export':'LocalInfoOperationSchema','output_schema_export':'LocalInfoOperationOutputWrappedSchema'},{'name':'wip_file','input_schema_export':'WipOperationsSchema','output_schema_export':'WipOperationOutputSchema'},{'name':'messenger_operation','input_schema_export':'MessengerOperationInputSchema','output_schema_export':'MessengerOperationOutputSchema'},{'name':'guard2file','input_schema_export':'Guard2File_InputSchema','output_schema_export':'Guard2File_OutputWrappedSchema'},{'name':'machineNode2file','input_schema_export':'MachineNode2File_InputSchema','output_schema_export':'MachineNode2File_OutputWrappedSchema'},{'name':'query_toolkit','input_schema_export':'WatchQueryOperationsSchema','output_schema_export':'WatchQueryOperationsResultSchema'},{'name':'onchain_table_data','input_schema_export':'OnchainTableDataSchema','output_schema_export':'OnchainTableDataResultSchema'},{'name':'onchain_events','input_schema_export':'OnchainEventsInputSchema','output_schema_export':'OnchainEventsResultSchema'},{'name':'wowok_buildin_info','input_schema_export':'ProtocolInfoQuerySchema','output_schema_export':'ProtocolInfoResultSchema'},{'name':'schema_query','input_schema_export':'SchemaQueryInputSchema','output_schema_export':'SchemaQueryOutputSchema'},{'name':'bridge_operation','input_schema_export':'BridgeOperationsSchema','output_schema_export':'BridgeCallOutputSchema'},{'name':'project_operation','input_schema_export':'ProjectOperationInputSchema','output_schema_export':'ProjectOperationOutputSchema'},{'name':'config_operation','input_schema_export':'ConfigOperationInputSchema','output_schema_export':'ConfigOperationOutputSchema'},{'name':'trust_score','input_schema_export':'TrustScoreInputSchema','output_schema_export':'TrustScoreOutputSchema'},{'name':'query_task_status','input_schema_export':'QueryTaskStatusInputSchema','output_schema_export':'QueryTaskStatusOutputSchema'},{'name':'evaluation_operation','input_schema_export':'EvaluationOperationInputSchema','output_schema_export':'EvaluationOperationOutputSchema'},{'name':'persona_operation','input_schema_export':'PersonaOperationInputSchema','output_schema_export':'PersonaOperationOutputSchema'},{'name':'intent_radar','input_schema_export':'IntentRadarInputSchema','output_schema_export':'IntentRadarOutputSchema'}];export function loadLayer4Deployed(a){const b=a116b['join'](DEPLOYED_TOOLS_DIR,a+'.json'),c={'tool_descriptor_file':b,'file_exists':![],'is_stub':!![],'properties_count':0x0,'required_count':0x0,'has_schema_hint':![],'has_additional_properties_false':![],'has_dollar_schema':![],'has_oneof':![],'has_anyof':![],'has_allof':![],'union_count':0x0};if(!a116a['existsSync'](b))return c;try{const d=a116a['readFileSync'](b,'utf-8'),e=JSON['parse'](d),f=e['arguments']??{},g=f['properties']??{},h=f['required']??[],i=Object['keys'](g),j=f['oneOf']??[],k=f['anyOf']??[],l=f['allOf']??[],m=j['length']>0x0,n=k['length']>0x0,o=l['length']>0x0,p=j['length']+k['length']+l['length'],q=i['length']===0x0&&p===0x0,r=e['description']??'',s=r['includes']('schema_query');return{'tool_descriptor_file':b,'file_exists':!![],'is_stub':q,'properties_count':i['length'],'required_count':h['length'],'has_schema_hint':s,'has_additional_properties_false':f['additionalProperties']===![],'has_dollar_schema':!!f['$schema'],'has_oneof':m,'has_anyof':n,'has_allof':o,'union_count':p};}catch{return c;}}export function loadLayer3Generated(a){const b=a116b['join'](GENERATED_SCHEMAS_DIR,a+'.schema.json'),c=a116b['join'](GENERATED_SCHEMAS_DIR,a+'.output.json'),d=a116a['existsSync'](b),e=a116a['existsSync'](c),f=d?a116a['statSync'](b)['size']:0x0,g=e?a116a['statSync'](c)['size']:0x0;return{'input_schema_file':b,'output_schema_file':c,'input_exists':d,'output_exists':e,'input_size_bytes':f,'output_size_bytes':g};}export function analyzeLayerCensus(){const a=[];for(const b of ALL_TOOLS){a['push']({'name':b['name'],'layer2_zod':{'input_schema_export':b['input_schema_export'],'output_schema_export':b['output_schema_export'],'schema_dir':MCP_SRC_SCHEMA_DIR},'layer3_generated':loadLayer3Generated(b['name']),'layer4_deployed':loadLayer4Deployed(b['name'])??{}});}return a;}export function analyzeDeployedStubInconsistency(a){const b=[],d=[],e=[];for(const f of a){if(!f['layer4_deployed']['file_exists']){b['push']({'rule_id':'MCP-DEPLOY-001','severity':'critical','category':'stub_inconsistency','tool_name':f['name'],'description':'Layer\x204\x20deployed\x20file\x20does\x20not\x20exist:\x20'+f['layer4_deployed']['tool_descriptor_file'],'location':f['layer4_deployed']['tool_descriptor_file'],'fix':'Create\x20'+f['name']+'.json\x20in\x20DEPLOYED_TOOLS_DIR\x20matching\x20the\x20Layer\x203\x20generated\x20schema.'});continue;}f['layer4_deployed']['is_stub']?d['push'](f):e['push'](f);}for(const g of d){b['push']({'rule_id':'MCP-STUB-001','severity':'high','category':'stub_inconsistency','tool_name':g['name'],'description':'Layer\x204\x20deployed\x20file\x20is\x20a\x20STUB\x20(empty\x20properties:{})\x20—\x20LLM\x20must\x20call\x20schema_query(action=\x27get\x27,\x20name=\x27'+g['name']+'\x27)\x20to\x20learn\x20the\x20parameter\x20structure.\x20This\x20is\x20inconsistent\x20with\x20the\x20'+e['length']+'\x20tools\x20that\x20embed\x20full\x20schemas.','location':g['layer4_deployed']['tool_descriptor_file'],'fix':'Regenerate\x20'+g['name']+'.json\x20from\x20dist/schemas/'+g['name']+'.schema.json\x20(resolve\x20$ref,\x20inline\x20definitions,\x20wrap\x20as\x20{name,\x20description,\x20arguments}).'}),!g['layer4_deployed']['has_schema_hint']&&b['push']({'rule_id':'MCP-STUB-003','severity':'high','category':'stub_inconsistency','tool_name':g['name'],'description':'Stub\x20file\x20is\x20missing\x20schema_query\x20hint\x20in\x20description\x20—\x20the\x20LLM\x20has\x20no\x20way\x20to\x20discover\x20the\x20parameter\x20structure.\x20Description\x20should\x20mention\x20schema_query(action=\x27get\x27,\x20name=\x27'+g['name']+'\x27).','location':g['layer4_deployed']['tool_descriptor_file'],'fix':'Add\x20\x22💡\x20Schema\x20hint:\x20Use\x20schema_query\x20with\x20action=\x27get\x27\x20and\x20name=\x27'+g['name']+'\x27\x20to\x20retrieve\x20the\x20exact\x20parameter\x20schema\x20before\x20calling.\x22\x20to\x20the\x20description.'});}return d['length']>0x0&&e['length']>0x0&&b['push']({'rule_id':'MCP-STUB-002','severity':'info','category':'stub_inconsistency','tool_name':'(all)','description':'Layer\x204\x20deployed\x20files\x20are\x20INCONSISTENT:\x20'+d['length']+'\x20stubs\x20+\x20'+e['length']+'\x20full\x20schemas.\x20Stubs:\x20'+d['map'](h=>h['name'])['join'](',\x20')+'.\x20Full:\x20'+e['map'](h=>h['name'])['join'](',\x20')+'.','fix':'Make\x20all\x2017\x20files\x20consistent\x20—\x20either\x20(a)\x20embed\x20full\x20schemas\x20in\x20all\x2017\x20(RECOMMENDED\x20—\x20gives\x20LLM\x20immediate\x20access),\x20or\x20(b)\x20keep\x20all\x20stubs\x20and\x20rely\x20on\x20schema_query\x20(increases\x20token\x20cost\x20+\x20latency).'}),b;}export function analyzeLayerParity(a){const b=[];for(const d of a){if(!d['layer4_deployed']['file_exists']||d['layer4_deployed']['is_stub'])continue;if(!d['layer3_generated']['input_exists']){b['push']({'rule_id':'MCP-PARITY-001','severity':'critical','category':'layer_parity','tool_name':d['name'],'description':'Layer\x204\x20has\x20full\x20schema\x20but\x20Layer\x203\x20generated\x20file\x20is\x20missing:\x20'+d['layer3_generated']['input_schema_file'],'fix':'Run\x20pnpm\x20generate:schemas\x20to\x20regenerate\x20Layer\x203\x20from\x20Zod\x20source.'});continue;}const e=readLayer4Arguments(d['name']),f=readLayer3ResolvedSchema(d['name']);if(!e||!f)continue;const g=new Set(Object['keys'](e['properties']??{})),h=new Set(Object['keys'](f['properties']??{})),i=[...h]['filter'](q=>!g['has'](q)),j=[...g]['filter'](q=>!h['has'](q));i['length']>0x0&&b['push']({'rule_id':'MCP-PARITY-002','severity':'high','category':'layer_parity','tool_name':d['name'],'description':'Layer\x204\x20deployed\x20schema\x20is\x20missing\x20'+i['length']+'\x20properties\x20present\x20in\x20Layer\x203\x20generated\x20schema:\x20'+i['join'](',\x20'),'location':d['layer4_deployed']['tool_descriptor_file'],'fix':'Regenerate\x20'+d['name']+'.json\x20from\x20dist/schemas/'+d['name']+'.schema.json.'});j['length']>0x0&&b['push']({'rule_id':'MCP-PARITY-003','severity':'medium','category':'layer_parity','tool_name':d['name'],'description':'Layer\x204\x20deployed\x20schema\x20has\x20'+j['length']+'\x20extra\x20properties\x20not\x20in\x20Layer\x203:\x20'+j['join'](',\x20'),'location':d['layer4_deployed']['tool_descriptor_file'],'fix':'Regenerate\x20'+d['name']+'.json\x20from\x20dist/schemas/'+d['name']+'.schema.json.'});const k=new Set(e['required']??[]),l=new Set(f['required']??[]),m=[...l]['filter'](q=>!k['has'](q)),n=[...k]['filter'](q=>!l['has'](q));(m['length']>0x0||n['length']>0x0)&&b['push']({'rule_id':'MCP-PARITY-004','severity':'high','category':'layer_parity','tool_name':d['name'],'description':'Layer\x204\x20\x27required\x27\x20array\x20differs\x20from\x20Layer\x203.\x20Missing\x20in\x20L4:\x20['+m['join'](',\x20')+'].\x20Extra\x20in\x20L4:\x20['+n['join'](',\x20')+'].','location':d['layer4_deployed']['tool_descriptor_file'],'fix':'Sync\x20\x27required\x27\x20array\x20from\x20Layer\x203\x20to\x20Layer\x204.'});const o=e['additionalProperties'],p=f['additionalProperties'];o!==p&&b['push']({'rule_id':'MCP-PARITY-005','severity':'medium','category':'layer_parity','tool_name':d['name'],'description':'Layer\x204\x20\x27additionalProperties\x27\x20('+JSON['stringify'](o)+')\x20differs\x20from\x20Layer\x203\x20('+JSON['stringify'](p)+').','location':d['layer4_deployed']['tool_descriptor_file'],'fix':'Sync\x20\x27additionalProperties\x27\x20value.'});}return b;}function readLayer4Arguments(a){const b=a116b['join'](DEPLOYED_TOOLS_DIR,a+'.json');try{const c=a116a['readFileSync'](b,'utf-8'),d=JSON['parse'](c);return d['arguments']??null;}catch{return null;}}function readLayer3ResolvedSchema(a){const b=a116b['join'](GENERATED_SCHEMAS_DIR,a+'.schema.json');try{const c=a116a['readFileSync'](b,'utf-8'),d=JSON['parse'](c);if(d['$ref']&&d['$ref']['startsWith']('#/definitions/')){const e=d['$ref']['slice']('#/definitions/'['length']),f=d['definitions']?.[e];if(f&&typeof f==='object')return f;}return d;}catch{return null;}}export function analyzeAnyUnknownCensus(){const a=[],b=[MCP_SRC_SCHEMA_DIR,MCP_SRC_TOOLS_DIR];for(const c of b){const d=listTypeScriptFiles(c);for(const e of d){const f=a116a['readFileSync'](e,'utf-8')['split']('\x0a');for(let g=0x0;g<f['length'];g++){const h=f[g],j=h['trim']();if(j['startsWith']('//')||j['startsWith']('*'))continue;const k=[{'regex':/z\.any\(\)/g,'pattern':'z.any()'},{'regex':/z\.unknown\(\)/g,'pattern':'z.unknown()'},{'regex':/args\s*:\s*any\b/g,'pattern':'args:\x20any'},{'regex':/Promise\s*<\s*any\s*>/g,'pattern':'Promise<any>'},{'regex':/Record\s*<\s*string\s*,\s*any\s*>/g,'pattern':'Record<string,\x20any>'},{'regex':/\bas\s+any\b/g,'pattern':'as\x20any'}];for(const {regex:l,pattern:n}of k){l['lastIndex']=0x0;let o;while((o=l['exec'](h))!==null){const p=categorizeAnyInstance(e,g+0x1,h,n);a['push']({'file':e,'line':g+0x1,'code':j['length']>0x78?j['slice'](0x0,0x75)+'...':j,'pattern':n,'category':p['category'],'reason':p['reason'],'fix_suggestion':p['fix']});}}}}}return a;}function listTypeScriptFiles(a){const b=[];if(!a116a['existsSync'](a))return b;const c=a116a['readdirSync'](a,{'withFileTypes':!![]});for(const d of c){const e=a116b['join'](a,d['name']);if(d['isDirectory']()){if(d['name']==='__tests__'||d['name']==='node_modules')continue;b['push'](...listTypeScriptFiles(e));}else d['isFile']()&&d['name']['endsWith']('.ts')&&b['push'](e);}return b;}function categorizeAnyInstance(a,b,c,d){const e=a116b['basename'](a),f=c['trim']();if(d==='z.any()'&&/SemanticSummarySchema\s*=\s*z\.any\(\)/['test'](f))return{'category':'fixable','reason':'Circular-dependency\x20workaround\x20for\x20SemanticSummarySchema\x20—\x20can\x20use\x20z.lazy()\x20or\x20refactor\x20to\x20break\x20the\x20cycle.','fix':'Define\x20SemanticSummarySchema\x20with\x20z.lazy(()\x20=>\x20SemanticSummarySchemaReal)\x20or\x20restructure\x20imports\x20to\x20break\x20the\x20cycle.'};if(d==='z.any()'&&/result\s*:\s*z\.any\(\)/['test'](f)&&/[\\/]config[\\/]|[\\/]project[\\/]/['test'](a))return{'category':'fixable','reason':'Result\x20shape\x20depends\x20on\x20action\x20—\x20can\x20use\x20z.discriminatedUnion(\x27action\x27,\x20[...])\x20to\x20type\x20each\x20action\x27s\x20result.','fix':'Define\x20discriminated\x20union:\x20z.discriminatedUnion(\x27action\x27,\x20[z.object({action:\x20z.literal(\x27list\x27),\x20result:\x20...}),\x20...]).'};if(d==='z.unknown()'&&/result\s*:\s*z\.unknown\(\)/['test'](f)&&/index\.ts/['test'](e))return{'category':'fixable','reason':'query_toolkit\x20output\x20result\x20depends\x20on\x20query_type\x20—\x20can\x20use\x20z.discriminatedUnion(\x27query_type\x27,\x20[...]).','fix':'Define\x20discriminated\x20union:\x20z.discriminatedUnion(\x27query_type\x27,\x20[z.object({query_type:\x20z.literal(\x27local_mark_list\x27),\x20result:\x20z.array(MarkDataSchema)}),\x20...]).'};if(d==='z.any()'&&/data\s*:\s*z\.any\(\)/['test'](f)&&/[\\/]schema-query[\\/]/['test'](a))return{'category':'fixable','reason':'SchemaQuery\x20output\x20data\x20depends\x20on\x20action\x20—\x20can\x20use\x20discriminated\x20union\x20by\x20action.','fix':'Define\x20discriminated\x20union:\x20action=\x27get\x27\x20returns\x20JSON\x20Schema,\x20action=\x27list\x27\x20returns\x20array\x20of\x20items.'};if(d==='args:\x20any'&&/handlers[\\/]/['test'](a))return{'category':'fixable','reason':'Handler\x20args\x20can\x20use\x20`unknown`\x20(forces\x20runtime\x20validation)\x20or\x20a\x20typed\x20input\x20schema.','fix':'Replace\x20`args:\x20any`\x20with\x20`args:\x20unknown`\x20and\x20use\x20strictParse(schema,\x20args)\x20at\x20the\x20top\x20of\x20the\x20handler.'};if(d==='args:\x20any'&&/tools[\\/]index\.ts/['test'](a))return{'category':'fixable','reason':'dispatchToolCall\x20args\x20is\x20`any`\x20—\x20can\x20be\x20`unknown`\x20since\x20each\x20tool\x20parses\x20with\x20its\x20own\x20schema.','fix':'Change\x20`args:\x20any`\x20to\x20`args:\x20unknown`\x20in\x20dispatchToolCall\x20signature.'};if(d==='args:\x20any'&&/types\.ts/['test'](e)&&/handler/['test'](f))return{'category':'fixable','reason':'ToolEntry.handler\x20args\x20is\x20`any`\x20—\x20can\x20be\x20`unknown`\x20(each\x20handler\x20parses\x20with\x20its\x20own\x20schema).','fix':'Change\x20`handler:\x20(args:\x20any)\x20=>\x20...`\x20to\x20`handler:\x20(args:\x20unknown)\x20=>\x20...`.'};if(d==='z.any()'&&/claimReceipt|ethReceipt|wowReceipt/['test'](f))return{'category':'legitimate','reason':'EVM\x20transaction\x20receipts\x20have\x20an\x20externally-defined\x20shape\x20from\x20viem/ethers\x20—\x20z.any()\x20is\x20acceptable\x20(receipt\x20is\x20informational,\x20not\x20validated).'};if(d==='z.any()'&&/content_raw/['test'](f))return{'category':'legitimate','reason':'content_raw\x20holds\x20raw\x20content\x20for\x20unknown\x20object\x20types\x20—\x20by\x20definition\x20untyped.\x20z.any()\x20is\x20acceptable\x20here.'};if((d==='z.unknown()'||d==='z.any()')&&/parsedJson/['test'](f))return{'category':'legitimate','reason':'Event\x20parsedJson\x20is\x20arbitrary\x20on-chain\x20event\x20data\x20—\x20z.record(z.string(),\x20z.unknown())\x20is\x20appropriate.'};if(d==='z.any()'&&/key_value/['test'](f))return{'category':'fixable','reason':'Repository\x20key_value\x20depends\x20on\x20key_type\x20—\x20could\x20use\x20discriminated\x20union\x20by\x20key_type\x20(string→z.string(),\x20u64→z.bigint()/number,\x20etc.).','fix':'Define\x20z.discriminatedUnion(\x27key_type\x27,\x20[...])\x20with\x20each\x20variant\x20typed.'};if(d==='z.unknown()'&&/data\s*:\s*z\.unknown\(\)/['test'](f)&&/[\\/]bridge/['test'](a))return{'category':'legitimate','reason':'Bridge\x20operation\x20result\x20data\x20varies\x20by\x20operation_type\x20—\x20currently\x209\x20different\x20shapes.\x20Discriminated\x20union\x20would\x20be\x20ideal\x20but\x20high\x20refactor\x20cost.'};if(d==='z.unknown()'&&/adjusted_params/['test'](f))return{'category':'legitimate','reason':'adjusted_params\x20are\x20free-form\x20key-value\x20pairs\x20suggested\x20by\x20AI\x20—\x20z.record(z.string(),\x20z.unknown())\x20is\x20appropriate.'};if(d==='z.any()'&&/object\s*:\s*z\.union.*z\.record\(z\.any\(\)/['test'](f))return{'category':'fixable','reason':'Creation\x20vs\x20reference\x20object\x20union\x20—\x20z.record(z.any())\x20should\x20be\x20replaced\x20with\x20NamedObjectSchema\x20(structured\x20creation\x20input).','fix':'Replace\x20z.record(z.any())\x20with\x20NamedObjectSchema\x20(already\x20defined\x20in\x20base.ts).'};if(d==='z.any()'&&/result\s*:\s*z\.any\(\)\.optional\(\)/['test'](f)&&/[\\/]bridge/['test'](a))return{'category':'legitimate','reason':'Bridge\x20result\x20is\x20operation-specific\x20(manage_evm_rpc\x20has\x20different\x20result\x20per\x20operation)\x20—\x20z.any().optional()\x20is\x20acceptable\x20here.'};if(d==='Promise<any>'&&/[\\/](wrap|shared)\.ts/['test'](a))return{'category':'fixable','reason':'Generic\x20wrappers\x20in\x20wrap.ts/shared.ts\x20use\x20Promise<any>\x20—\x20could\x20be\x20made\x20generic\x20<T>.','fix':'Replace\x20`Promise<any>`\x20with\x20`Promise<ToolDispatchResult>`\x20(the\x20actual\x20return\x20shape).'};if(d==='Record<string,\x20any>'&&/types\.ts/['test'](e)&&/_meta|structuredContent/['test'](f))return{'category':'fixable','reason':'ToolConfig._meta\x20and\x20ToolDispatchResult.structuredContent\x20could\x20use\x20structured\x20types.','fix':'Define\x20ToolMeta\x20interface\x20(category,\x20tags)\x20and\x20replace\x20structuredContent:\x20any\x20with\x20structured\x20type.'};if(d==='as\x20any')return{'category':'legitimate','reason':'`as\x20any`\x20cast\x20—\x20usually\x20for\x20third-party\x20type\x20mismatches\x20(MCP\x20SDK).\x20Acceptable\x20if\x20isolated.'};return{'category':'legitimate','reason':'Unclassified\x20any/unknown\x20usage\x20—\x20review\x20manually.\x20Defaulting\x20to\x20legitimate\x20(no\x20auto-fix).'};}export function analyzeHandlerTypeSafety(a){const b=[];for(const c of a){if(c['pattern']!=='args:\x20any')continue;if(!/tools[\\/]/['test'](c['file']))continue;b['push']({'rule_id':'MCP-HANDLER-001','severity':'medium','category':'handler_types','tool_name':a116b['basename'](c['file'],'.ts'),'description':'Handler\x20uses\x20`args:\x20any`\x20—\x20bypasses\x20TypeScript\x20type\x20checking.\x20'+c['reason'],'location':c['file']+':'+c['line'],'fix':c['fix_suggestion']});}return b;}export function analyzeOutputSchemaCoverage(a){const b=[];for(const d of a){!d['layer3_generated']['output_exists']&&d['name']!=='onchain_operations'&&b['push']({'rule_id':'MCP-OUTPUT-001','severity':'high','category':'output_coverage','tool_name':d['name'],'description':'Layer\x203\x20output\x20schema\x20file\x20does\x20not\x20exist:\x20'+d['layer3_generated']['output_schema_file'],'fix':'Add\x20outputSchema\x20to\x20'+d['name']+'\x27s\x20tool\x20definition\x20and\x20regenerate\x20schemas.'}),d['layer2_zod']['output_schema_export']===null&&b['push']({'rule_id':'MCP-OUTPUT-002','severity':'medium','category':'output_coverage','tool_name':d['name'],'description':'Layer\x202\x20outputSchema\x20is\x20defined\x20inline\x20(not\x20exported\x20with\x20a\x20stable\x20name).\x20This\x20makes\x20it\x20harder\x20to\x20reference\x20from\x20tests.','fix':'Export\x20the\x20outputSchema\x20with\x20a\x20stable\x20name\x20(e.g.,\x20'+d['name']+'OutputSchema).'});}return b;}export function analyzeGenerationScriptSync(){const a=[];if(!a116a['existsSync'](GENERATION_SCRIPT))return a['push']({'rule_id':'MCP-GENSYNC-001','severity':'critical','category':'generation_sync','tool_name':'(all)','description':'Generation\x20script\x20not\x20found:\x20'+GENERATION_SCRIPT}),a;const b=a116a['readFileSync'](GENERATION_SCRIPT,'utf-8'),c=/name:\s*["']([^"']+)["']/g,d=new Set();let e;while((e=c['exec'](b))!==null){ALL_TOOLS['some'](f=>f['name']===e[0x1])&&d['add'](e[0x1]);}for(const f of ALL_TOOLS){!d['has'](f['name'])&&a['push']({'rule_id':'MCP-GENSYNC-002','severity':'high','category':'generation_sync','tool_name':f['name'],'description':'Tool\x20\x22'+f['name']+'\x22\x20is\x20in\x20TOOL_REGISTRY\x20but\x20missing\x20from\x20generate-json-schemas.ts.\x20Layer\x203\x20schemas\x20will\x20not\x20be\x20generated.','location':GENERATION_SCRIPT,'fix':'Add\x20a\x20get'+toPascalCase(f['name'])+'Tool()\x20function\x20and\x20add\x20it\x20to\x20the\x20tools\x20array.'});}return a;}function toPascalCase(a){return a['split']('_')['map'](b=>b['charAt'](0x0)['toUpperCase']()+b['slice'](0x1)['toLowerCase']())['join']('');}export function analyzeSchemaQueryReflection(a){const b=[];for(const e of a){!e['layer3_generated']['input_exists']&&b['push']({'rule_id':'MCP-REFLECT-001','severity':'high','category':'reflection','tool_name':e['name'],'description':'schema_query(action=\x27get\x27,\x20name=\x27'+e['name']+'\x27)\x20would\x20fail\x20—\x20Layer\x203\x20input\x20schema\x20missing.','fix':'Run\x20pnpm\x20generate:schemas.'}),!e['layer3_generated']['output_exists']&&e['name']!=='onchain_operations'&&b['push']({'rule_id':'MCP-REFLECT-002','severity':'medium','category':'reflection','tool_name':e['name'],'description':'schema_query(action=\x27get_output\x27,\x20name=\x27'+e['name']+'\x27)\x20would\x20fail\x20—\x20Layer\x203\x20output\x20schema\x20missing.','fix':'Run\x20pnpm\x20generate:schemas.'});}const d=['permission','service','machine','progress','guard','arbitration','repository','contact','treasury','reward','allocation','personal','payment','demand','order','gen_passport','proof','gen_proof'];for(const f of d){const g=a116b['join'](GENERATED_SCHEMAS_DIR,'onchain_operations_'+f+'.schema.json');!a116a['existsSync'](g)&&b['push']({'rule_id':'MCP-REFLECT-003','severity':'medium','category':'reflection','tool_name':'onchain_operations_'+f,'description':'Individual\x20operation\x20schema\x20missing:\x20'+g+'.\x20schema_query(action=\x27get\x27,\x20name=\x27onchain_operations_'+f+'\x27)\x20would\x20fail.','fix':'Run\x20pnpm\x20generate:schemas.'});}return b;}export function scanAllMcpSchemas(){const a=analyzeLayerCensus(),b=analyzeAnyUnknownCensus(),c=[...analyzeDeployedStubInconsistency(a),...analyzeLayerParity(a),...analyzeHandlerTypeSafety(b),...analyzeOutputSchemaCoverage(a),...analyzeGenerationScriptSync(),...analyzeSchemaQueryReflection(a)],d=new Map(),e=new Map();for(const l of c){if(!d['has'](l['severity']))d['set'](l['severity'],[]);d['get'](l['severity'])['push'](l);if(!e['has'](l['category']))e['set'](l['category'],[]);e['get'](l['category'])['push'](l);}const g=b['filter'](m=>m['category']==='fixable')['length'],h=b['filter'](m=>m['category']==='legitimate')['length'],i=b['filter'](m=>m['category']==='external')['length'],j=a['filter'](m=>m['layer4_deployed']['is_stub'])['length'],k=a['filter'](m=>!m['layer4_deployed']['is_stub']&&m['layer4_deployed']['file_exists'])['length'];return{'census':a,'findings':c,'any_unknown_instances':b,'findings_by_severity':d,'findings_by_category':e,'total_findings':c['length'],'fixable_any_count':g,'legitimate_any_count':h,'external_any_count':i,'stub_count':j,'full_schema_count':k};}export function formatAuditReport(a){const b=[];b['push']('#\x20MCP\x20Schema\x20Audit\x20Report\x20—\x2017\x20WoWok\x20Tools'),b['push'](''),b['push']('>\x20Auto-generated\x20by\x20`mcp-schema-audit.ts`\x20v'+MCP_SCHEMA_AUDIT_VERSION+'\x20—\x20comprehensive'),b['push']('>\x204-layer\x20audit\x20of\x20schema\x20consistency,\x20any/unknown\x20usage,\x20and\x20I/O\x20coverage.'),b['push'](''),b['push']('##\x20Summary'),b['push'](''),b['push']('-\x20**Tools\x20audited**:\x20'+a['census']['length']),b['push']('-\x20**Total\x20findings**:\x20'+a['total_findings']),b['push']('-\x20**Stub\x20files**:\x20'+a['stub_count']+'\x20/\x20'+a['census']['length']),b['push']('-\x20**Full\x20schema\x20files**:\x20'+a['full_schema_count']+'\x20/\x20'+a['census']['length']),b['push']('-\x20**any/unknown\x20instances**:\x20'+a['any_unknown_instances']['length']+'\x20total'),b['push']('\x20\x20-\x20Fixable:\x20'+a['fixable_any_count']),b['push']('\x20\x20-\x20Legitimate:\x20'+a['legitimate_any_count']),b['push']('\x20\x20-\x20External:\x20'+a['external_any_count']),b['push'](''),b['push']('###\x20Findings\x20by\x20Severity'),b['push'](''),b['push']('|\x20Severity\x20|\x20Count\x20|'),b['push']('|----------|-------|');for(const h of['critical','high','medium','low','info']){const i=a['findings_by_severity']['get'](h)??[];b['push']('|\x20'+h+'\x20|\x20'+i['length']+'\x20|');}b['push'](''),b['push']('###\x20Findings\x20by\x20Category'),b['push'](''),b['push']('|\x20Category\x20|\x20Count\x20|'),b['push']('|----------|-------|');for(const j of['stub_inconsistency','layer_parity','handler_types','output_coverage','generation_sync','reflection']){const k=a['findings_by_category']['get'](j)??[];b['push']('|\x20'+j+'\x20|\x20'+k['length']+'\x20|');}b['push'](''),b['push']('##\x20Layer\x20Census\x20—\x20All\x2017\x20Tools'),b['push'](''),b['push']('|\x20Tool\x20|\x20L3\x20Input\x20|\x20L3\x20Output\x20|\x20L4\x20Status\x20|\x20L4\x20Properties\x20|\x20L4\x20Required\x20|'),b['push']('|------|----------|-----------|-----------|---------------|-------------|');for(const l of a['census']){const m=l['layer3_generated']['input_exists']?'✓\x20'+(l['layer3_generated']['input_size_bytes']/0x400)['toFixed'](0x1)+'KB':'✗\x20MISSING',n=l['layer3_generated']['output_exists']?'✓\x20'+(l['layer3_generated']['output_size_bytes']/0x400)['toFixed'](0x1)+'KB':'✗\x20MISSING',o=!l['layer4_deployed']['file_exists']?'✗\x20MISSING':l['layer4_deployed']['is_stub']?'⚠\x20STUB':'✓\x20FULL',p=l['layer4_deployed']['properties_count'],q=l['layer4_deployed']['required_count'];b['push']('|\x20'+l['name']+'\x20|\x20'+m+'\x20|\x20'+n+'\x20|\x20'+o+'\x20|\x20'+p+'\x20|\x20'+q+'\x20|');}b['push'](''),b['push']('##\x20Findings\x20Detail'),b['push']('');const d=['critical','high','medium','low','info'];for(const r of d){const s=a['findings_by_severity']['get'](r)??[];if(s['length']===0x0)continue;const t=r['toUpperCase']();b['push']('###\x20'+t+'\x20('+s['length']+')'),b['push']('');for(const u of s){b['push']('-\x20**['+u['rule_id']+']\x20'+u['description']);if(u['location'])b['push']('\x20\x20-\x20Location:\x20`'+u['location']+'`');if(u['fix'])b['push']('\x20\x20-\x20Fix:\x20'+u['fix']);b['push']('');}}b['push']('##\x20any/unknown\x20Census\x20Detail'),b['push'](''),b['push']('Total\x20instances:\x20'+a['any_unknown_instances']['length']),b['push'](''),b['push']('###\x20By\x20Pattern'),b['push'](''),b['push']('|\x20Pattern\x20|\x20Total\x20|\x20Fixable\x20|\x20Legitimate\x20|\x20External\x20|'),b['push']('|---------|-------|---------|------------|----------|');const e=new Map();for(const v of a['any_unknown_instances']){if(!e['has'](v['pattern']))e['set'](v['pattern'],[]);e['get'](v['pattern'])['push'](v);}for(const [w,x]of[...e['entries']()]['sort']((y,z)=>z[0x1]['length']-y[0x1]['length'])){const y=x['filter'](B=>B['category']==='fixable')['length'],z=x['filter'](B=>B['category']==='legitimate')['length'],A=x['filter'](B=>B['category']==='external')['length'];b['push']('|\x20`'+w+'`\x20|\x20'+x['length']+'\x20|\x20'+y+'\x20|\x20'+z+'\x20|\x20'+A+'\x20|');}b['push']('');const g=a['any_unknown_instances']['filter'](B=>B['category']==='fixable');if(g['length']>0x0){b['push']('###\x20Fixable\x20Instances\x20(Priority\x20List)'),b['push']('');for(const B of g){b['push']('-\x20**'+a116b['basename'](B['file'])+':'+B['line']+'**\x20[`'+B['pattern']+'`]'),b['push']('\x20\x20-\x20Code:\x20`'+B['code']+'`'),b['push']('\x20\x20-\x20Reason:\x20'+B['reason']);if(B['fix_suggestion'])b['push']('\x20\x20-\x20Fix:\x20'+B['fix_suggestion']);b['push']('');}}return b['push']('##\x20Recommended\x20Action\x20Plan'),b['push'](''),b['push']('###\x20Phase\x201:\x20Fix\x20Layer\x204\x20Stub\x20Inconsistency\x20(CRITICAL\x20UX)'),b['push'](''),b['push']('The\x20'+a['stub_count']+'\x20stub\x20files\x20force\x20the\x20LLM\x20to\x20call\x20`schema_query`\x20first,\x20creating\x20an\x20extra\x20round-trip.\x20Fix\x20by\x20regenerating\x20all\x2017\x20Layer\x204\x20files\x20from\x20Layer\x203\x20schemas:'),b['push'](''),b['push']('```bash'),b['push']('#\x201.\x20Generate\x20Layer\x203\x20schemas\x20from\x20Zod\x20source'),b['push']('cd\x20d:/wowok/agent/mcp\x20&&\x20pnpm\x20generate:schemas'),b['push'](''),b['push']('#\x202.\x20Generate\x20Layer\x204\x20deployed\x20files\x20from\x20Layer\x203'),b['push']('#\x20(Run\x20the\x20new\x20sync-deployed-tools.ts\x20script\x20—\x20see\x20E2.4)'),b['push']('npx\x20tsx\x20scripts/sync-deployed-tools.ts'),b['push']('```'),b['push'](''),b['push']('###\x20Phase\x202:\x20Type\x20the\x20'+a['fixable_any_count']+'\x20fixable\x20any/unknown\x20instances'),b['push'](''),b['push']('Priority\x20order:'),b['push'](''),b['push']('1.\x20**SemanticSummarySchema**\x20(src/schema/local/index.ts:6)\x20—\x20use\x20`z.lazy()`'),b['push']('2.\x20**ConfigOperationOutputSchema.result**\x20(src/schema/config/index.ts:17)\x20—\x20discriminated\x20union\x20by\x20action'),b['push']('3.\x20**ProjectOperationOutputSchema.result**\x20(src/schema/project/index.ts:34)\x20—\x20discriminated\x20union\x20by\x20action'),b['push']('4.\x20**query_toolkit\x20output\x20result**\x20(src/tools/index.ts:250)\x20—\x20discriminated\x20union\x20by\x20query_type'),b['push']('5.\x20**SchemaQueryOutputSchema.data**\x20(src/schema/schema-query/index.ts:34)\x20—\x20discriminated\x20union\x20by\x20action'),b['push']('6.\x20**RepositoryKeyValueSchema.key_value**\x20(src/schema/operations.ts:331)\x20—\x20discriminated\x20union\x20by\x20key_type'),b['push']('7.\x20**Handler\x20args:\x20any**\x20—\x20replace\x20with\x20`unknown`\x20(forces\x20strictParse\x20at\x20top\x20of\x20handler)'),b['push']('8.\x20**dispatchToolCall(name,\x20args:\x20any)**\x20—\x20replace\x20with\x20`unknown`'),b['push'](''),b['push']('###\x20Phase\x203:\x20Verify\x20I/O\x20Schema\x20Match'),b['push'](''),b['push']('For\x20each\x20tool,\x20write\x20a\x20parity\x20test\x20that:'),b['push']('1.\x20Calls\x20the\x20handler\x20with\x20a\x20minimal\x20valid\x20input'),b['push']('2.\x20Captures\x20the\x20structuredContent'),b['push']('3.\x20Validates\x20structuredContent\x20against\x20outputSchema'),b['push']('4.\x20Reports\x20any\x20mismatch'),b['push'](''),b['join']('\x0a');}