@wowok/agent-mcp 2.7.1 → 2.7.3

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

@@ -1,777 +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 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(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 ALL_TOOLS) {
-        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 (ALL_TOOLS.some(t => t.name === m[1])) {
-            scriptNames.add(m[1]);
-        }
-    }
-    for (const tool of ALL_TOOLS) {
-        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 a137a from'fs';import*as a137b from'path';import{CONCEPT_GLOSSARY}from'./glossary.js';export const TRAE_MCPS_ROOT='c:\x5cUsers\x5czhou\x5c.trae-cn\x5cmcps';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='2.1.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'},{'name':'employee_operation','input_schema_export':'EmployeeOperationInputSchema','output_schema_export':'EmployeeOperationOutputSchema'},{'name':'industry_pack_operation','input_schema_export':'IndustryPackOperationInputSchema','output_schema_export':'IndustryPackOperationOutputSchema'},{'name':'workspace_operation','input_schema_export':'WorkspaceOperationInputSchema','output_schema_export':'WorkspaceOperationOutputSchema'}];export function discoverDeployedGatewayMounts(){const a=[];if(!a137a['existsSync'](TRAE_MCPS_ROOT))return[];for(const b of a137a['readdirSync'](TRAE_MCPS_ROOT,{'withFileTypes':!![]})){if(!b['isDirectory']())continue;const c=a137b['join'](TRAE_MCPS_ROOT,b['name'],'solo_agent','mcp_wagent','tools','wowok.json');try{const d=a137a['statSync'](c);if(d['isFile']())a['push']({'file':c,'mtime':d['mtimeMs']});}catch{}}return a['sort']((e,f)=>f['mtime']-e['mtime']),a['map'](e=>e['file']);}const GATEWAY_MISSING={'gateway_file':a137b['join'](TRAE_MCPS_ROOT,'<none>','solo_agent','mcp_wagent','tools','wowok.json'),'file_exists':![],'gateway_name':null,'has_definitions':![],'definitions_count':0x0,'has_tool_field':![],'has_data_field':![],'is_strict':![],'has_schema_hint':![],'size_bytes':0x0,'all_mounts':[]};export function loadLayer4Gateway(){const a=discoverDeployedGatewayMounts();if(a['length']===0x0)return GATEWAY_MISSING;const b=a[0x0];try{const c=a137a['readFileSync'](b,'utf-8'),d=JSON['parse'](c),e=d['arguments']??{},f=e['definitions']??{},g=Object['keys'](f)['length'];let h=e;const i=e['$ref'];if(i&&i['startsWith']('#/definitions/')){const l=i['slice']('#/definitions/'['length']),m=f[l];if(m&&typeof m==='object')h=m;}const j=h['properties']??{},k=d['description']??'';return{'gateway_file':b,'file_exists':!![],'gateway_name':d['name']??null,'has_definitions':g>0x0,'definitions_count':g,'has_tool_field':'tool'in j,'has_data_field':'data'in j,'is_strict':h['additionalProperties']===![],'has_schema_hint':k['includes']('schema_query'),'size_bytes':Buffer['byteLength'](c,'utf-8'),'all_mounts':a};}catch{return{...GATEWAY_MISSING,'gateway_file':b,'all_mounts':a};}}export function loadLayer3Generated(a){const b=a137b['join'](GENERATED_SCHEMAS_DIR,a+'.schema.json'),c=a137b['join'](GENERATED_SCHEMAS_DIR,a+'.output.json'),d=a137a['existsSync'](b),e=a137a['existsSync'](c),f=d?a137a['statSync'](b)['size']:0x0,g=e?a137a['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'])});}return a;}export function analyzeGatewayDeployment(a){const b=[],c='(gateway)';if(!a['file_exists'])return b['push']({'rule_id':'MCP-GATEWAY-001','severity':'critical','category':'gateway_deployment','tool_name':c,'description':'No\x20deployed\x20wowok.json\x20gateway\x20descriptor\x20found\x20under\x20any\x20Trae\x20mount\x20in\x20'+TRAE_MCPS_ROOT+'.\x20The\x20MCP\x20server\x20is\x20not\x20loaded\x20by\x20any\x20Trae\x20session,\x20or\x20tools/list\x20failed.','fix':'Load\x20the\x20WoWok\x20MCP\x20server\x20in\x20a\x20Trae\x20session\x20and\x20verify\x20tools/list\x20returns\x20the\x20single\x20\x27wowok\x27\x20tool.'}),b;return a['gateway_name']!=='wowok'&&b['push']({'rule_id':'MCP-GATEWAY-002','severity':'high','category':'gateway_deployment','tool_name':c,'description':'Deployed\x20gateway\x20descriptor\x20name\x20is\x20\x27'+a['gateway_name']+'\x27\x20—\x20expected\x20\x27wowok\x27\x20(the\x20single\x20unified\x20tool\x20registered\x20by\x20the\x20server).','location':a['gateway_file'],'fix':'Restart\x20the\x20Trae\x20session\x20so\x20Trae\x20regenerates\x20wowok.json\x20from\x20the\x20server\x27s\x20tools/list.'}),!a['has_definitions']&&a['definitions_count']===0x0&&b['push']({'rule_id':'MCP-GATEWAY-003','severity':'high','category':'gateway_deployment','tool_name':c,'description':'Deployed\x20gateway\x20descriptor\x20carries\x20no\x20argument\x20schema\x20(no\x20definitions,\x20no\x20properties)\x20—\x20the\x20LLM\x20has\x20no\x20parameter\x20structure\x20at\x20all.','location':a['gateway_file'],'fix':'Ensure\x20listTools()\x20advertises\x20WowokToolDisplaySchema\x20and\x20restart\x20the\x20Trae\x20session.'}),!a['has_schema_hint']&&b['push']({'rule_id':'MCP-GATEWAY-004','severity':'medium','category':'gateway_deployment','tool_name':c,'description':'Gateway\x20descriptor\x20description\x20does\x20not\x20mention\x20schema_query\x20—\x20the\x20LLM\x20is\x20not\x20told\x20about\x20the\x20schema\x20self-correction\x20path\x20(sub-tool\x20schemas\x20are\x20returned\x20on\x20validation\x20mismatch).','location':a['gateway_file'],'fix':'Keep\x20the\x20schema_query\x20mention\x20in\x20WOWOK_TOOL_DESCRIPTION\x20(src/tools/index.ts).'}),b;}export function analyzeGatewayDispatchContract(a){const b=[],c='(gateway)';if(!a['file_exists'])return b;const d=[];if(!a['has_tool_field'])d['push']('tool');if(!a['has_data_field'])d['push']('data');return d['length']>0x0&&b['push']({'rule_id':'MCP-PARITY-001','severity':'high','category':'layer_parity','tool_name':c,'description':'Deployed\x20gateway\x20argument\x20schema\x20is\x20missing\x20dispatch\x20field(s):\x20'+d['join'](',\x20')+'.\x20Calls\x20of\x20the\x20form\x20wowok({\x20tool,\x20data\x20})\x20cannot\x20be\x20validated.','location':a['gateway_file'],'fix':'Ensure\x20WowokToolDisplaySchema\x20exposes\x20tool/data\x20properties\x20and\x20restart\x20the\x20Trae\x20session.'}),!a['is_strict']&&b['push']({'rule_id':'MCP-PARITY-002','severity':'medium','category':'layer_parity','tool_name':c,'description':'Deployed\x20gateway\x20root\x20schema\x20is\x20not\x20strict\x20(additionalProperties\x20!==\x20false)\x20—\x20unknown\x20keys\x20silently\x20pass\x20the\x20client-side\x20check.','location':a['gateway_file'],'fix':'Keep\x20additionalProperties:false\x20on\x20WowokToolDisplaySchema\x20(aliases\x20are\x20explicit\x20properties).'}),b;}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=a137a['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(!a137a['existsSync'](a))return b;const c=a137a['readdirSync'](a,{'withFileTypes':!![]});for(const d of c){const e=a137b['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=a137b['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':a137b['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(!a137a['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=a137a['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=a137b['join'](GENERATED_SCHEMAS_DIR,'onchain_operations_'+f+'.schema.json');!a137a['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;}function normalizeGlossaryTerm(a){return a['toLowerCase']()['replace'](/[-_\s]/g,'');}const GLOSSARY_ALIAS_INDEX=((()=>{const a=new Set(CONCEPT_GLOSSARY['map'](c=>normalizeGlossaryTerm(c['term']))),b=new Map();for(const c of CONCEPT_GLOSSARY){for(const d of c['aliases']){const e=normalizeGlossaryTerm(d);if(a['has'](e))continue;if(!b['has'](e))b['set'](e,c['term']);}}return b;})());function collectSchemaProperties(a,b,c){if(!a||typeof a!=='object')return;const d=a;if(d['properties']&&typeof d['properties']==='object')for(const e of Object['keys'](d['properties'])){c['push']({'file':b,'property':e}),collectSchemaProperties(d['properties'][e],b,c);}if(d['definitions']&&typeof d['definitions']==='object')for(const f of Object['keys'](d['definitions'])){collectSchemaProperties(d['definitions'][f],b,c);}if(d['items'])collectSchemaProperties(d['items'],b,c);if(Array['isArray'](d['anyOf']))d['anyOf']['forEach'](g=>collectSchemaProperties(g,b,c));if(Array['isArray'](d['oneOf']))d['oneOf']['forEach'](g=>collectSchemaProperties(g,b,c));d['additionalProperties']&&typeof d['additionalProperties']==='object'&&collectSchemaProperties(d['additionalProperties'],b,c);}export function analyzeGlossaryAlignment(){const a=[];if(!a137a['existsSync'](GENERATED_SCHEMAS_DIR))return a;const b=a137a['readdirSync'](GENERATED_SCHEMAS_DIR)['filter'](d=>d['endsWith']('.schema.json')||d['endsWith']('.output.json')),c=new Set();for(const d of b){const e=a137b['join'](GENERATED_SCHEMAS_DIR,d);let f;try{f=JSON['parse'](a137a['readFileSync'](e,'utf-8'));}catch{continue;}const g=[];collectSchemaProperties(f,d,g);for(const h of g){const i=normalizeGlossaryTerm(h['property']),j=GLOSSARY_ALIAS_INDEX['get'](i);if(!j)continue;const k=h['file']+'::'+h['property'];if(c['has'](k))continue;c['add'](k),a['push']({'rule_id':'MCP-GLOSSARY-001','severity':'medium','category':'glossary_alignment','tool_name':d['replace'](/\.(schema|output)\.json$/,''),'description':'Schema\x20field\x20\x27'+h['property']+'\x27\x20uses\x20a\x20deprecated\x20glossary\x20alias\x20—\x20the\x20canonical\x20term\x20is\x20\x27'+j+'\x27.','location':e,'fix':'Rename\x20the\x20field\x20to\x20the\x20canonical\x20term\x20(camelCase/snake_case\x20of\x20\x27'+j+'\x27).'});}}return a;}export function scanAllMcpSchemas(){const a=analyzeLayerCensus(),b=loadLayer4Gateway(),c=analyzeAnyUnknownCensus(),d=[...analyzeGatewayDeployment(b),...analyzeGatewayDispatchContract(b),...analyzeHandlerTypeSafety(c),...analyzeOutputSchemaCoverage(a),...analyzeGenerationScriptSync(),...analyzeSchemaQueryReflection(a),...analyzeGlossaryAlignment()],e=new Map(),g=new Map();for(const k of d){if(!e['has'](k['severity']))e['set'](k['severity'],[]);e['get'](k['severity'])['push'](k);if(!g['has'](k['category']))g['set'](k['category'],[]);g['get'](k['category'])['push'](k);}const h=c['filter'](l=>l['category']==='fixable')['length'],i=c['filter'](l=>l['category']==='legitimate')['length'],j=c['filter'](l=>l['category']==='external')['length'];return{'census':a,'gateway':b,'findings':d,'any_unknown_instances':c,'findings_by_severity':e,'findings_by_category':g,'total_findings':d['length'],'fixable_any_count':h,'legitimate_any_count':i,'external_any_count':j};}export function formatAuditReport(a){const b=[];b['push']('#\x20MCP\x20Schema\x20Audit\x20Report\x20—\x20'+a['census']['length']+'\x20WoWok\x20Sub-Tools\x20+\x20Unified\x20Gateway'),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**Gateway\x20deployed**:\x20'+(a['gateway']['file_exists']?'yes\x20('+a['gateway']['all_mounts']['length']+'\x20Trae\x20mount(s))':'NO')),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']('-\x20**Glossary\x20alignment**:\x20'+(a['findings_by_category']['get']('glossary_alignment')??[])['length']+'\x20deprecated-alias\x20schema\x20field(s)'),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['gateway_deployment','layer_parity','handler_types','output_coverage','generation_sync','reflection','glossary_alignment']){const k=a['findings_by_category']['get'](j)??[];b['push']('|\x20'+j+'\x20|\x20'+k['length']+'\x20|');}b['push'](''),b['push']('##\x20Layer\x204\x20—\x20Deployed\x20Gateway'),b['push']('');a['gateway']['file_exists']?(b['push']('-\x20**Descriptor**:\x20`'+a['gateway']['gateway_file']+'`\x20('+(a['gateway']['size_bytes']/0x400)['toFixed'](0x1)+'KB)'),b['push']('-\x20**Name**:\x20'+a['gateway']['gateway_name']),b['push']('-\x20**Dispatch\x20contract**:\x20tool='+(a['gateway']['has_tool_field']?'✓':'✗')+'\x20data='+(a['gateway']['has_data_field']?'✓':'✗')+'\x20strict='+(a['gateway']['is_strict']?'✓':'✗')),b['push']('-\x20**Definitions**:\x20'+a['gateway']['definitions_count']),b['push']('-\x20**schema_query\x20hint**:\x20'+(a['gateway']['has_schema_hint']?'✓':'✗')),b['push']('-\x20**Trae\x20mounts**:\x20'+a['gateway']['all_mounts']['length'])):b['push']('-\x20✗\x20No\x20wowok.json\x20found\x20under\x20any\x20Trae\x20mount\x20in\x20'+TRAE_MCPS_ROOT);b['push'](''),b['push']('##\x20Layer\x20Census\x20—\x20All\x20'+a['census']['length']+'\x20Sub-Tools\x20(dispatched\x20via\x20the\x20wowok\x20gateway)'),b['push'](''),b['push']('|\x20Tool\x20|\x20L3\x20Input\x20|\x20L3\x20Output\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';b['push']('|\x20'+l['name']+'\x20|\x20'+m+'\x20|\x20'+n+'\x20|');}b['push'](''),b['push']('##\x20Findings\x20Detail'),b['push']('');const d=['critical','high','medium','low','info'];for(const o of d){const p=a['findings_by_severity']['get'](o)??[];if(p['length']===0x0)continue;const q=o['toUpperCase']();b['push']('###\x20'+q+'\x20('+p['length']+')'),b['push']('');for(const r of p){b['push']('-\x20**['+r['rule_id']+']\x20'+r['description']);if(r['location'])b['push']('\x20\x20-\x20Location:\x20`'+r['location']+'`');if(r['fix'])b['push']('\x20\x20-\x20Fix:\x20'+r['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 s of a['any_unknown_instances']){if(!e['has'](s['pattern']))e['set'](s['pattern'],[]);e['get'](s['pattern'])['push'](s);}for(const [t,u]of[...e['entries']()]['sort']((v,w)=>w[0x1]['length']-v[0x1]['length'])){const v=u['filter'](y=>y['category']==='fixable')['length'],w=u['filter'](y=>y['category']==='legitimate')['length'],x=u['filter'](y=>y['category']==='external')['length'];b['push']('|\x20`'+t+'`\x20|\x20'+u['length']+'\x20|\x20'+v+'\x20|\x20'+w+'\x20|\x20'+x+'\x20|');}b['push']('');const g=a['any_unknown_instances']['filter'](y=>y['category']==='fixable');if(g['length']>0x0){b['push']('###\x20Fixable\x20Instances\x20(Priority\x20List)'),b['push']('');for(const y of g){b['push']('-\x20**'+a137b['basename'](y['file'])+':'+y['line']+'**\x20[`'+y['pattern']+'`]'),b['push']('\x20\x20-\x20Code:\x20`'+y['code']+'`'),b['push']('\x20\x20-\x20Reason:\x20'+y['reason']);if(y['fix_suggestion'])b['push']('\x20\x20-\x20Fix:\x20'+y['fix_suggestion']);b['push']('');}}return b['push']('##\x20Recommended\x20Action\x20Plan'),b['push'](''),b['push']('###\x20Phase\x201:\x20Keep\x20the\x20Layer\x203\x20schema\x20set\x20regenerable'),b['push'](''),b['push']('Layer\x204\x20(the\x20deployed\x20wowok.json\x20gateway)\x20is\x20CLIENT-generated\x20from\x20our\x20tools/list\x20—\x20keep\x20Layer\x203\x20in\x20sync\x20so\x20schema_query\x20reflection\x20always\x20serves\x20fresh\x20schemas:'),b['push'](''),b['push']('```bash'),b['push']('cd\x20d:/wowok/agent/mcp\x20&&\x20pnpm\x20generate:schemas'),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');}