@naeemo/capnp 0.8.1 → 0.9.1

package/dist/cli-DlZBZozW.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+import { t as SchemaNodeType } from "./schema-types-GVRD1pwE.js";
+import { readFileSync } from "node:fs";
+
+//#region src/compat/index.ts
+/**
+* Check compatibility between two schemas
+*/
+function checkCompatibility(oldSchema, newSchema, options) {
+	const opts = {
+		strictRenames: false,
+		allowRemoveDeprecated: false,
+		checkUnions: true,
+		...options
+	};
+	const issues = [];
+	const oldNodes = Array.isArray(oldSchema) ? oldSchema : [oldSchema];
+	const newNodes = Array.isArray(newSchema) ? newSchema : [newSchema];
+	const oldMap = new Map(oldNodes.map((n) => [n.id, n]));
+	const newMap = new Map(newNodes.map((n) => [n.id, n]));
+	for (const oldNode of oldNodes) {
+		const newNode = newMap.get(oldNode.id);
+		if (!newNode) {
+			if (oldNode.type === SchemaNodeType.STRUCT) issues.push({
+				type: "breaking",
+				category: "struct_removed",
+				message: `Struct '${oldNode.displayName}' was removed`,
+				path: oldNode.displayName,
+				suggestion: "Consider deprecating before removing"
+			});
+			continue;
+		}
+		compareNodes(oldNode, newNode, issues, opts);
+	}
+	for (const newNode of newNodes) {
+		const oldNode = oldMap.get(newNode.id);
+		if (oldNode) checkNewRequiredFields(oldNode, newNode, issues);
+	}
+	const breaking = issues.filter((i) => i.type === "breaking").length;
+	const warning = issues.filter((i) => i.type === "warning").length;
+	const info = issues.filter((i) => i.type === "info").length;
+	return {
+		compatible: breaking === 0,
+		issues,
+		summary: {
+			breaking,
+			warning,
+			info
+		},
+		oldVersion: oldNodes[0] ? {
+			id: oldNodes[0].id,
+			displayName: oldNodes[0].displayName
+		} : void 0,
+		newVersion: newNodes[0] ? {
+			id: newNodes[0].id,
+			displayName: newNodes[0].displayName
+		} : void 0
+	};
+}
+function compareNodes(oldNode, newNode, issues, options) {
+	if (oldNode.type !== newNode.type) {
+		issues.push({
+			type: "breaking",
+			category: "field_type_changed",
+			message: `Node '${oldNode.displayName}' type changed from ${SchemaNodeType[oldNode.type]} to ${SchemaNodeType[newNode.type]}`,
+			path: oldNode.displayName
+		});
+		return;
+	}
+	if (oldNode.type === SchemaNodeType.STRUCT && newNode.type === SchemaNodeType.STRUCT) compareStructs(oldNode, newNode, issues, options);
+	if (oldNode.type === SchemaNodeType.ENUM && newNode.type === SchemaNodeType.ENUM) compareEnums(oldNode, newNode, issues);
+}
+function compareStructs(oldNode, newNode, issues, options) {
+	if (!oldNode.structInfo || !newNode.structInfo) return;
+	const oldFields = new Map(oldNode.structInfo.fields.map((f) => [f.name, f]));
+	const newFields = new Map(newNode.structInfo.fields.map((f) => [f.name, f]));
+	for (const [name, oldField] of oldFields) {
+		if (!newFields.has(name)) {
+			issues.push({
+				type: "breaking",
+				category: "field_removed",
+				message: `Field '${oldNode.displayName}.${name}' was removed`,
+				path: `${oldNode.displayName}.${name}`,
+				suggestion: "Consider deprecating before removing"
+			});
+			continue;
+		}
+		compareFields(oldField, newFields.get(name), oldNode.displayName, issues);
+	}
+	if (options.checkUnions) {
+		if (oldNode.structInfo.discriminantCount !== newNode.structInfo.discriminantCount) issues.push({
+			type: "breaking",
+			category: "union_changed",
+			message: `Union in '${oldNode.displayName}' changed`,
+			path: oldNode.displayName,
+			suggestion: "Avoid changing union structure"
+		});
+	}
+}
+function compareFields(oldField, newField, structName, issues) {
+	const oldType = oldField.type.kind.type;
+	const newType = newField.type.kind.type;
+	if (oldType !== newType) {
+		issues.push({
+			type: "breaking",
+			category: "field_type_changed",
+			message: `Field '${structName}.${oldField.name}' type changed from ${oldType} to ${newType}`,
+			path: `${structName}.${oldField.name}`,
+			suggestion: "Create new field with different name instead of changing type"
+		});
+		return;
+	}
+}
+function compareEnums(oldNode, newNode, issues) {
+	if (!oldNode.enumInfo || !newNode.enumInfo) return;
+	const newValues = new Set(newNode.enumInfo.enumerants.map((e) => e.name));
+	for (const oldValue of oldNode.enumInfo.enumerants) if (!newValues.has(oldValue.name)) issues.push({
+		type: "breaking",
+		category: "enum_value_removed",
+		message: `Enum value '${oldNode.displayName}.${oldValue.name}' was removed`,
+		path: `${oldNode.displayName}.${oldValue.name}`,
+		suggestion: "Reserve enum values instead of removing them"
+	});
+}
+function checkNewRequiredFields(oldNode, newNode, issues) {
+	if (!oldNode.structInfo || !newNode.structInfo) return;
+	const oldFields = new Set(oldNode.structInfo.fields.map((f) => f.name));
+	for (const newField of newNode.structInfo.fields) if (!oldFields.has(newField.name)) issues.push({
+		type: "info",
+		category: "field_added_optional",
+		message: `New field '${newNode.displayName}.${newField.name}' added`,
+		path: `${newNode.displayName}.${newField.name}`
+	});
+}
+/**
+* Format compatibility report as human-readable text
+*/
+function formatReport(report) {
+	const lines = [];
+	lines.push("=".repeat(60));
+	lines.push("SCHEMA COMPATIBILITY REPORT");
+	lines.push("=".repeat(60));
+	lines.push("");
+	if (report.compatible) lines.push("✅ Schemas are compatible");
+	else lines.push("❌ Schemas are NOT compatible");
+	lines.push("");
+	lines.push("Summary:");
+	lines.push(`  Breaking: ${report.summary.breaking}`);
+	lines.push(`  Warnings: ${report.summary.warning}`);
+	lines.push(`  Info: ${report.summary.info}`);
+	lines.push("");
+	if (report.issues.length > 0) {
+		lines.push("Issues:");
+		lines.push("-".repeat(60));
+		for (const issue of report.issues) {
+			const icon = issue.type === "breaking" ? "❌" : issue.type === "warning" ? "⚠️" : "ℹ️";
+			lines.push(`${icon} [${issue.type.toUpperCase()}] ${issue.category}`);
+			lines.push(`   Path: ${issue.path}`);
+			lines.push(`   ${issue.message}`);
+			if (issue.suggestion) lines.push(`   💡 ${issue.suggestion}`);
+			lines.push("");
+		}
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+//#region src/compat/cli.ts
+/**
+* Schema Compatibility Checker CLI
+*
+* Check compatibility between Cap'n Proto schema versions
+*
+* Usage: capnp compat <old-schema> <new-schema> [options]
+*/
+const VERSION = "0.9.0";
+function printUsage() {
+	console.log(`
+Cap'n Proto Schema Compatibility Checker v${VERSION}
+
+Usage: capnp compat <old-schema> <new-schema> [options]
+
+Arguments:
+  old-schema    Path to old schema JSON file
+  new-schema    Path to new schema JSON file
+
+Options:
+  --strict-renames      Treat field renames as breaking
+  --allow-remove-dep    Allow removing deprecated fields
+  --json                Output as JSON
+  --quiet               Only output errors
+  -h, --help            Show this help
+
+Examples:
+  capnp compat schema-v1.json schema-v2.json
+  capnp compat old.json new.json --json
+  capnp compat old.json new.json --strict-renames
+`);
+}
+function parseArgs(args) {
+	const options = {};
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "-h" || arg === "--help") {
+			printUsage();
+			process.exit(0);
+		}
+		if (arg === "--strict-renames") options.strictRenames = true;
+		else if (arg === "--allow-remove-dep") options.allowRemoveDeprecated = true;
+		else if (arg === "--json") options.json = true;
+		else if (arg === "--quiet") options.quiet = true;
+		else if (!arg.startsWith("-")) {
+			if (!options.oldSchema) options.oldSchema = arg;
+			else if (!options.newSchema) options.newSchema = arg;
+		}
+	}
+	return options;
+}
+function loadSchema(path) {
+	const content = readFileSync(path, "utf-8");
+	const parsed = JSON.parse(content);
+	return (Array.isArray(parsed) ? parsed : [parsed]).map((node) => ({
+		...node,
+		id: typeof node.id === "string" ? BigInt(node.id) : node.id,
+		scopeId: typeof node.scopeId === "string" ? BigInt(node.scopeId) : node.scopeId ?? 0n
+	}));
+}
+async function run(args) {
+	const options = parseArgs(args);
+	if (!options.oldSchema || !options.newSchema) {
+		console.error("Error: Both old and new schema files are required");
+		printUsage();
+		process.exit(1);
+	}
+	try {
+		const report = checkCompatibility(loadSchema(options.oldSchema), loadSchema(options.newSchema), {
+			strictRenames: options.strictRenames,
+			allowRemoveDeprecated: options.allowRemoveDeprecated
+		});
+		if (options.json) console.log(JSON.stringify(report, (_, v) => typeof v === "bigint" ? v.toString() : v, 2));
+		else if (!options.quiet) console.log(formatReport(report));
+		process.exit(report.compatible ? 0 : 1);
+	} catch (err) {
+		console.error("Error:", err instanceof Error ? err.message : err);
+		process.exit(2);
+	}
+}
+
+//#endregion
+export { run };
+//# sourceMappingURL=cli-DlZBZozW.js.map

package/dist/cli-DlZBZozW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-DlZBZozW.js","names":[],"sources":["../src/compat/index.ts","../src/compat/cli.ts"],"sourcesContent":["/**\n * Schema Compatibility Checker\n *\n * Detect breaking changes between Cap'n Proto schema versions.\n */\n\nimport type { SchemaField, SchemaNode } from '../rpc/schema-types.js';\nimport { SchemaNodeType } from '../rpc/schema-types.js';\n\nexport interface CompatibilityOptions {\n  /** Treat field renames as breaking (default: false) */\n  strictRenames?: boolean;\n  /** Allow removing deprecated fields (default: false) */\n  allowRemoveDeprecated?: boolean;\n  /** Check union changes (default: true) */\n  checkUnions?: boolean;\n}\n\nexport interface CompatibilityIssue {\n  /** Type of compatibility issue */\n  type: 'breaking' | 'warning' | 'info';\n  /** Category of the issue */\n  category:\n    | 'field_removed'\n    | 'field_type_changed'\n    | 'field_default_changed'\n    | 'struct_removed'\n    | 'enum_value_removed'\n    | 'union_changed'\n    | 'capability_added'\n    | 'field_added_optional'\n    | 'field_added_required';\n  /** Human-readable description */\n  message: string;\n  /** Path to the affected element */\n  path: string;\n  /** Suggested fix */\n  suggestion?: string;\n}\n\nexport interface CompatibilityReport {\n  /** Whether schemas are compatible */\n  compatible: boolean;\n  /** List of all issues */\n  issues: CompatibilityIssue[];\n  /** Summary counts */\n  summary: {\n    breaking: number;\n    warning: number;\n    info: number;\n  };\n  /** Old schema version info */\n  oldVersion?: {\n    id: bigint;\n    displayName: string;\n  };\n  /** New schema version info */\n  newVersion?: {\n    id: bigint;\n    displayName: string;\n  };\n}\n\n/**\n * Check compatibility between two schemas\n */\nexport function checkCompatibility(\n  oldSchema: SchemaNode | SchemaNode[],\n  newSchema: SchemaNode | SchemaNode[],\n  options?: CompatibilityOptions\n): CompatibilityReport {\n  const opts = {\n    strictRenames: false,\n    allowRemoveDeprecated: false,\n    checkUnions: true,\n    ...options,\n  };\n\n  const issues: CompatibilityIssue[] = [];\n\n  // Normalize to arrays\n  const oldNodes = Array.isArray(oldSchema) ? oldSchema : [oldSchema];\n  const newNodes = Array.isArray(newSchema) ? newSchema : [newSchema];\n\n  // Build maps for quick lookup\n  const oldMap = new Map(oldNodes.map((n) => [n.id, n]));\n  const newMap = new Map(newNodes.map((n) => [n.id, n]));\n\n  // Check each old node\n  for (const oldNode of oldNodes) {\n    const newNode = newMap.get(oldNode.id);\n\n    if (!newNode) {\n      // Node was removed\n      if (oldNode.type === SchemaNodeType.STRUCT) {\n        issues.push({\n          type: 'breaking',\n          category: 'struct_removed',\n          message: `Struct '${oldNode.displayName}' was removed`,\n          path: oldNode.displayName,\n          suggestion: 'Consider deprecating before removing',\n        });\n      }\n      continue;\n    }\n\n    // Compare same-id nodes\n    compareNodes(oldNode, newNode, issues, opts);\n  }\n\n  // Check for new required fields (also breaking)\n  for (const newNode of newNodes) {\n    const oldNode = oldMap.get(newNode.id);\n    if (oldNode) {\n      checkNewRequiredFields(oldNode, newNode, issues);\n    }\n  }\n\n  const breaking = issues.filter((i) => i.type === 'breaking').length;\n  const warning = issues.filter((i) => i.type === 'warning').length;\n  const info = issues.filter((i) => i.type === 'info').length;\n\n  return {\n    compatible: breaking === 0,\n    issues,\n    summary: { breaking, warning, info },\n    oldVersion: oldNodes[0]\n      ? { id: oldNodes[0].id, displayName: oldNodes[0].displayName }\n      : undefined,\n    newVersion: newNodes[0]\n      ? { id: newNodes[0].id, displayName: newNodes[0].displayName }\n      : undefined,\n  };\n}\n\nfunction compareNodes(\n  oldNode: SchemaNode,\n  newNode: SchemaNode,\n  issues: CompatibilityIssue[],\n  options: Required<CompatibilityOptions>\n): void {\n  // Check type hasn't changed\n  if (oldNode.type !== newNode.type) {\n    issues.push({\n      type: 'breaking',\n      category: 'field_type_changed',\n      message: `Node '${oldNode.displayName}' type changed from ${SchemaNodeType[oldNode.type]} to ${SchemaNodeType[newNode.type]}`,\n      path: oldNode.displayName,\n    });\n    return;\n  }\n\n  // Compare structs\n  if (oldNode.type === SchemaNodeType.STRUCT && newNode.type === SchemaNodeType.STRUCT) {\n    compareStructs(oldNode, newNode, issues, options);\n  }\n\n  // Compare enums\n  if (oldNode.type === SchemaNodeType.ENUM && newNode.type === SchemaNodeType.ENUM) {\n    compareEnums(oldNode, newNode, issues);\n  }\n}\n\nfunction compareStructs(\n  oldNode: SchemaNode,\n  newNode: SchemaNode,\n  issues: CompatibilityIssue[],\n  options: Required<CompatibilityOptions>\n): void {\n  if (!oldNode.structInfo || !newNode.structInfo) return;\n\n  const oldFields = new Map(oldNode.structInfo.fields.map((f) => [f.name, f]));\n  const newFields = new Map(newNode.structInfo.fields.map((f) => [f.name, f]));\n\n  // Check for removed fields\n  for (const [name, oldField] of oldFields) {\n    if (!newFields.has(name)) {\n      issues.push({\n        type: 'breaking',\n        category: 'field_removed',\n        message: `Field '${oldNode.displayName}.${name}' was removed`,\n        path: `${oldNode.displayName}.${name}`,\n        suggestion: 'Consider deprecating before removing',\n      });\n      continue;\n    }\n\n    // Compare field types\n    const newField = newFields.get(name)!;\n    compareFields(oldField, newField, oldNode.displayName, issues);\n  }\n\n  // Check union changes\n  if (options.checkUnions) {\n    const oldUnionCount = oldNode.structInfo.discriminantCount;\n    const newUnionCount = newNode.structInfo.discriminantCount;\n\n    if (oldUnionCount !== newUnionCount) {\n      issues.push({\n        type: 'breaking',\n        category: 'union_changed',\n        message: `Union in '${oldNode.displayName}' changed`,\n        path: oldNode.displayName,\n        suggestion: 'Avoid changing union structure',\n      });\n    }\n  }\n}\n\nfunction compareFields(\n  oldField: SchemaField,\n  newField: SchemaField,\n  structName: string,\n  issues: CompatibilityIssue[]\n): void {\n  // Check type changes\n  const oldType = oldField.type.kind.type;\n  const newType = newField.type.kind.type;\n\n  if (oldType !== newType) {\n    issues.push({\n      type: 'breaking',\n      category: 'field_type_changed',\n      message: `Field '${structName}.${oldField.name}' type changed from ${oldType} to ${newType}`,\n      path: `${structName}.${oldField.name}`,\n      suggestion: 'Create new field with different name instead of changing type',\n    });\n    return;\n  }\n\n  // Check for required -> optional (safe) vs optional -> required (breaking)\n  // This is handled in checkNewRequiredFields\n}\n\nfunction compareEnums(\n  oldNode: SchemaNode,\n  newNode: SchemaNode,\n  issues: CompatibilityIssue[]\n): void {\n  if (!oldNode.enumInfo || !newNode.enumInfo) return;\n\n  const newValues = new Set(newNode.enumInfo.enumerants.map((e) => e.name));\n\n  for (const oldValue of oldNode.enumInfo.enumerants) {\n    if (!newValues.has(oldValue.name)) {\n      issues.push({\n        type: 'breaking',\n        category: 'enum_value_removed',\n        message: `Enum value '${oldNode.displayName}.${oldValue.name}' was removed`,\n        path: `${oldNode.displayName}.${oldValue.name}`,\n        suggestion: 'Reserve enum values instead of removing them',\n      });\n    }\n  }\n}\n\nfunction checkNewRequiredFields(\n  oldNode: SchemaNode,\n  newNode: SchemaNode,\n  issues: CompatibilityIssue[]\n): void {\n  if (!oldNode.structInfo || !newNode.structInfo) return;\n\n  const oldFields = new Set(oldNode.structInfo.fields.map((f) => f.name));\n\n  for (const newField of newNode.structInfo.fields) {\n    if (!oldFields.has(newField.name)) {\n      // This is a new field\n      // In Cap'n Proto, all fields are effectively optional (have defaults)\n      // So adding fields is safe\n      issues.push({\n        type: 'info',\n        category: 'field_added_optional',\n        message: `New field '${newNode.displayName}.${newField.name}' added`,\n        path: `${newNode.displayName}.${newField.name}`,\n      });\n    }\n  }\n}\n\n/**\n * Format compatibility report as human-readable text\n */\nexport function formatReport(report: CompatibilityReport): string {\n  const lines: string[] = [];\n\n  lines.push('='.repeat(60));\n  lines.push('SCHEMA COMPATIBILITY REPORT');\n  lines.push('='.repeat(60));\n  lines.push('');\n\n  if (report.compatible) {\n    lines.push('✅ Schemas are compatible');\n  } else {\n    lines.push('❌ Schemas are NOT compatible');\n  }\n  lines.push('');\n\n  lines.push('Summary:');\n  lines.push(`  Breaking: ${report.summary.breaking}`);\n  lines.push(`  Warnings: ${report.summary.warning}`);\n  lines.push(`  Info: ${report.summary.info}`);\n  lines.push('');\n\n  if (report.issues.length > 0) {\n    lines.push('Issues:');\n    lines.push('-'.repeat(60));\n\n    for (const issue of report.issues) {\n      const icon = issue.type === 'breaking' ? '❌' : issue.type === 'warning' ? '⚠️' : 'ℹ️';\n      lines.push(`${icon} [${issue.type.toUpperCase()}] ${issue.category}`);\n      lines.push(`   Path: ${issue.path}`);\n      lines.push(`   ${issue.message}`);\n      if (issue.suggestion) {\n        lines.push(`   💡 ${issue.suggestion}`);\n      }\n      lines.push('');\n    }\n  }\n\n  return lines.join('\\n');\n}\n","/**\n * Schema Compatibility Checker CLI\n *\n * Check compatibility between Cap'n Proto schema versions\n *\n * Usage: capnp compat <old-schema> <new-schema> [options]\n */\n\nimport { readFileSync } from 'node:fs';\nimport type { SchemaNode } from '../rpc/schema-types.js';\nimport { checkCompatibility, formatReport } from './index.js';\n\nconst VERSION = '0.9.0';\n\nfunction printUsage() {\n  console.log(`\nCap'n Proto Schema Compatibility Checker v${VERSION}\n\nUsage: capnp compat <old-schema> <new-schema> [options]\n\nArguments:\n  old-schema    Path to old schema JSON file\n  new-schema    Path to new schema JSON file\n\nOptions:\n  --strict-renames      Treat field renames as breaking\n  --allow-remove-dep    Allow removing deprecated fields\n  --json                Output as JSON\n  --quiet               Only output errors\n  -h, --help            Show this help\n\nExamples:\n  capnp compat schema-v1.json schema-v2.json\n  capnp compat old.json new.json --json\n  capnp compat old.json new.json --strict-renames\n`);\n}\n\nfunction parseArgs(args: string[]) {\n  const options: {\n    oldSchema?: string;\n    newSchema?: string;\n    strictRenames?: boolean;\n    allowRemoveDeprecated?: boolean;\n    json?: boolean;\n    quiet?: boolean;\n  } = {};\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (arg === '-h' || arg === '--help') {\n      printUsage();\n      process.exit(0);\n    }\n\n    if (arg === '--strict-renames') {\n      options.strictRenames = true;\n    } else if (arg === '--allow-remove-dep') {\n      options.allowRemoveDeprecated = true;\n    } else if (arg === '--json') {\n      options.json = true;\n    } else if (arg === '--quiet') {\n      options.quiet = true;\n    } else if (!arg.startsWith('-')) {\n      if (!options.oldSchema) {\n        options.oldSchema = arg;\n      } else if (!options.newSchema) {\n        options.newSchema = arg;\n      }\n    }\n  }\n\n  return options;\n}\n\nfunction loadSchema(path: string): SchemaNode | SchemaNode[] {\n  const content = readFileSync(path, 'utf-8');\n  const parsed = JSON.parse(content);\n\n  // Handle array or single object\n  const nodes = Array.isArray(parsed) ? parsed : [parsed];\n\n  // Convert string IDs to bigints\n  return nodes.map((node: Record<string, unknown>) => ({\n    ...node,\n    id: typeof node.id === 'string' ? BigInt(node.id) : node.id,\n    scopeId: typeof node.scopeId === 'string' ? BigInt(node.scopeId) : (node.scopeId ?? 0n),\n  })) as SchemaNode[];\n}\n\nexport async function run(args: string[]): Promise<void> {\n  const options = parseArgs(args);\n\n  if (!options.oldSchema || !options.newSchema) {\n    console.error('Error: Both old and new schema files are required');\n    printUsage();\n    process.exit(1);\n  }\n\n  try {\n    const oldSchema = loadSchema(options.oldSchema);\n    const newSchema = loadSchema(options.newSchema);\n\n    const report = checkCompatibility(oldSchema, newSchema, {\n      strictRenames: options.strictRenames,\n      allowRemoveDeprecated: options.allowRemoveDeprecated,\n    });\n\n    if (options.json) {\n      console.log(JSON.stringify(report, (_, v) => (typeof v === 'bigint' ? v.toString() : v), 2));\n    } else if (!options.quiet) {\n      console.log(formatReport(report));\n    }\n\n    // Exit with error code if not compatible\n    process.exit(report.compatible ? 0 : 1);\n  } catch (err) {\n    console.error('Error:', err instanceof Error ? err.message : err);\n    process.exit(2);\n  }\n}\n"],"mappings":";;;;;;;AAkEA,SAAgB,mBACd,WACA,WACA,SACqB;CACrB,MAAM,OAAO;EACX,eAAe;EACf,uBAAuB;EACvB,aAAa;EACb,GAAG;EACJ;CAED,MAAM,SAA+B,EAAE;CAGvC,MAAM,WAAW,MAAM,QAAQ,UAAU,GAAG,YAAY,CAAC,UAAU;CACnE,MAAM,WAAW,MAAM,QAAQ,UAAU,GAAG,YAAY,CAAC,UAAU;CAGnE,MAAM,SAAS,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;CACtD,MAAM,SAAS,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAGtD,MAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,UAAU,OAAO,IAAI,QAAQ,GAAG;AAEtC,MAAI,CAAC,SAAS;AAEZ,OAAI,QAAQ,SAAS,eAAe,OAClC,QAAO,KAAK;IACV,MAAM;IACN,UAAU;IACV,SAAS,WAAW,QAAQ,YAAY;IACxC,MAAM,QAAQ;IACd,YAAY;IACb,CAAC;AAEJ;;AAIF,eAAa,SAAS,SAAS,QAAQ,KAAK;;AAI9C,MAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,UAAU,OAAO,IAAI,QAAQ,GAAG;AACtC,MAAI,QACF,wBAAuB,SAAS,SAAS,OAAO;;CAIpD,MAAM,WAAW,OAAO,QAAQ,MAAM,EAAE,SAAS,WAAW,CAAC;CAC7D,MAAM,UAAU,OAAO,QAAQ,MAAM,EAAE,SAAS,UAAU,CAAC;CAC3D,MAAM,OAAO,OAAO,QAAQ,MAAM,EAAE,SAAS,OAAO,CAAC;AAErD,QAAO;EACL,YAAY,aAAa;EACzB;EACA,SAAS;GAAE;GAAU;GAAS;GAAM;EACpC,YAAY,SAAS,KACjB;GAAE,IAAI,SAAS,GAAG;GAAI,aAAa,SAAS,GAAG;GAAa,GAC5D;EACJ,YAAY,SAAS,KACjB;GAAE,IAAI,SAAS,GAAG;GAAI,aAAa,SAAS,GAAG;GAAa,GAC5D;EACL;;AAGH,SAAS,aACP,SACA,SACA,QACA,SACM;AAEN,KAAI,QAAQ,SAAS,QAAQ,MAAM;AACjC,SAAO,KAAK;GACV,MAAM;GACN,UAAU;GACV,SAAS,SAAS,QAAQ,YAAY,sBAAsB,eAAe,QAAQ,MAAM,MAAM,eAAe,QAAQ;GACtH,MAAM,QAAQ;GACf,CAAC;AACF;;AAIF,KAAI,QAAQ,SAAS,eAAe,UAAU,QAAQ,SAAS,eAAe,OAC5E,gBAAe,SAAS,SAAS,QAAQ,QAAQ;AAInD,KAAI,QAAQ,SAAS,eAAe,QAAQ,QAAQ,SAAS,eAAe,KAC1E,cAAa,SAAS,SAAS,OAAO;;AAI1C,SAAS,eACP,SACA,SACA,QACA,SACM;AACN,KAAI,CAAC,QAAQ,cAAc,CAAC,QAAQ,WAAY;CAEhD,MAAM,YAAY,IAAI,IAAI,QAAQ,WAAW,OAAO,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5E,MAAM,YAAY,IAAI,IAAI,QAAQ,WAAW,OAAO,KAAK,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAG5E,MAAK,MAAM,CAAC,MAAM,aAAa,WAAW;AACxC,MAAI,CAAC,UAAU,IAAI,KAAK,EAAE;AACxB,UAAO,KAAK;IACV,MAAM;IACN,UAAU;IACV,SAAS,UAAU,QAAQ,YAAY,GAAG,KAAK;IAC/C,MAAM,GAAG,QAAQ,YAAY,GAAG;IAChC,YAAY;IACb,CAAC;AACF;;AAKF,gBAAc,UADG,UAAU,IAAI,KAAK,EACF,QAAQ,aAAa,OAAO;;AAIhE,KAAI,QAAQ,aAIV;MAHsB,QAAQ,WAAW,sBACnB,QAAQ,WAAW,kBAGvC,QAAO,KAAK;GACV,MAAM;GACN,UAAU;GACV,SAAS,aAAa,QAAQ,YAAY;GAC1C,MAAM,QAAQ;GACd,YAAY;GACb,CAAC;;;AAKR,SAAS,cACP,UACA,UACA,YACA,QACM;CAEN,MAAM,UAAU,SAAS,KAAK,KAAK;CACnC,MAAM,UAAU,SAAS,KAAK,KAAK;AAEnC,KAAI,YAAY,SAAS;AACvB,SAAO,KAAK;GACV,MAAM;GACN,UAAU;GACV,SAAS,UAAU,WAAW,GAAG,SAAS,KAAK,sBAAsB,QAAQ,MAAM;GACnF,MAAM,GAAG,WAAW,GAAG,SAAS;GAChC,YAAY;GACb,CAAC;AACF;;;AAOJ,SAAS,aACP,SACA,SACA,QACM;AACN,KAAI,CAAC,QAAQ,YAAY,CAAC,QAAQ,SAAU;CAE5C,MAAM,YAAY,IAAI,IAAI,QAAQ,SAAS,WAAW,KAAK,MAAM,EAAE,KAAK,CAAC;AAEzE,MAAK,MAAM,YAAY,QAAQ,SAAS,WACtC,KAAI,CAAC,UAAU,IAAI,SAAS,KAAK,CAC/B,QAAO,KAAK;EACV,MAAM;EACN,UAAU;EACV,SAAS,eAAe,QAAQ,YAAY,GAAG,SAAS,KAAK;EAC7D,MAAM,GAAG,QAAQ,YAAY,GAAG,SAAS;EACzC,YAAY;EACb,CAAC;;AAKR,SAAS,uBACP,SACA,SACA,QACM;AACN,KAAI,CAAC,QAAQ,cAAc,CAAC,QAAQ,WAAY;CAEhD,MAAM,YAAY,IAAI,IAAI,QAAQ,WAAW,OAAO,KAAK,MAAM,EAAE,KAAK,CAAC;AAEvE,MAAK,MAAM,YAAY,QAAQ,WAAW,OACxC,KAAI,CAAC,UAAU,IAAI,SAAS,KAAK,CAI/B,QAAO,KAAK;EACV,MAAM;EACN,UAAU;EACV,SAAS,cAAc,QAAQ,YAAY,GAAG,SAAS,KAAK;EAC5D,MAAM,GAAG,QAAQ,YAAY,GAAG,SAAS;EAC1C,CAAC;;;;;AAQR,SAAgB,aAAa,QAAqC;CAChE,MAAM,QAAkB,EAAE;AAE1B,OAAM,KAAK,IAAI,OAAO,GAAG,CAAC;AAC1B,OAAM,KAAK,8BAA8B;AACzC,OAAM,KAAK,IAAI,OAAO,GAAG,CAAC;AAC1B,OAAM,KAAK,GAAG;AAEd,KAAI,OAAO,WACT,OAAM,KAAK,2BAA2B;KAEtC,OAAM,KAAK,+BAA+B;AAE5C,OAAM,KAAK,GAAG;AAEd,OAAM,KAAK,WAAW;AACtB,OAAM,KAAK,eAAe,OAAO,QAAQ,WAAW;AACpD,OAAM,KAAK,eAAe,OAAO,QAAQ,UAAU;AACnD,OAAM,KAAK,WAAW,OAAO,QAAQ,OAAO;AAC5C,OAAM,KAAK,GAAG;AAEd,KAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,QAAM,KAAK,UAAU;AACrB,QAAM,KAAK,IAAI,OAAO,GAAG,CAAC;AAE1B,OAAK,MAAM,SAAS,OAAO,QAAQ;GACjC,MAAM,OAAO,MAAM,SAAS,aAAa,MAAM,MAAM,SAAS,YAAY,OAAO;AACjF,SAAM,KAAK,GAAG,KAAK,IAAI,MAAM,KAAK,aAAa,CAAC,IAAI,MAAM,WAAW;AACrE,SAAM,KAAK,YAAY,MAAM,OAAO;AACpC,SAAM,KAAK,MAAM,MAAM,UAAU;AACjC,OAAI,MAAM,WACR,OAAM,KAAK,SAAS,MAAM,aAAa;AAEzC,SAAM,KAAK,GAAG;;;AAIlB,QAAO,MAAM,KAAK,KAAK;;;;;;;;;;;;ACpTzB,MAAM,UAAU;AAEhB,SAAS,aAAa;AACpB,SAAQ,IAAI;4CAC8B,QAAQ;;;;;;;;;;;;;;;;;;;EAmBlD;;AAGF,SAAS,UAAU,MAAgB;CACjC,MAAM,UAOF,EAAE;AAEN,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;AAEjB,MAAI,QAAQ,QAAQ,QAAQ,UAAU;AACpC,eAAY;AACZ,WAAQ,KAAK,EAAE;;AAGjB,MAAI,QAAQ,mBACV,SAAQ,gBAAgB;WACf,QAAQ,qBACjB,SAAQ,wBAAwB;WACvB,QAAQ,SACjB,SAAQ,OAAO;WACN,QAAQ,UACjB,SAAQ,QAAQ;WACP,CAAC,IAAI,WAAW,IAAI,EAC7B;OAAI,CAAC,QAAQ,UACX,SAAQ,YAAY;YACX,CAAC,QAAQ,UAClB,SAAQ,YAAY;;;AAK1B,QAAO;;AAGT,SAAS,WAAW,MAAyC;CAC3D,MAAM,UAAU,aAAa,MAAM,QAAQ;CAC3C,MAAM,SAAS,KAAK,MAAM,QAAQ;AAMlC,SAHc,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,EAG1C,KAAK,UAAmC;EACnD,GAAG;EACH,IAAI,OAAO,KAAK,OAAO,WAAW,OAAO,KAAK,GAAG,GAAG,KAAK;EACzD,SAAS,OAAO,KAAK,YAAY,WAAW,OAAO,KAAK,QAAQ,GAAI,KAAK,WAAW;EACrF,EAAE;;AAGL,eAAsB,IAAI,MAA+B;CACvD,MAAM,UAAU,UAAU,KAAK;AAE/B,KAAI,CAAC,QAAQ,aAAa,CAAC,QAAQ,WAAW;AAC5C,UAAQ,MAAM,oDAAoD;AAClE,cAAY;AACZ,UAAQ,KAAK,EAAE;;AAGjB,KAAI;EAIF,MAAM,SAAS,mBAHG,WAAW,QAAQ,UAAU,EAC7B,WAAW,QAAQ,UAAU,EAES;GACtD,eAAe,QAAQ;GACvB,uBAAuB,QAAQ;GAChC,CAAC;AAEF,MAAI,QAAQ,KACV,SAAQ,IAAI,KAAK,UAAU,SAAS,GAAG,MAAO,OAAO,MAAM,WAAW,EAAE,UAAU,GAAG,GAAI,EAAE,CAAC;WACnF,CAAC,QAAQ,MAClB,SAAQ,IAAI,aAAa,OAAO,CAAC;AAInC,UAAQ,KAAK,OAAO,aAAa,IAAI,EAAE;UAChC,KAAK;AACZ,UAAQ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,IAAI;AACjE,UAAQ,KAAK,EAAE"}

package/dist/cli-audit-j58Eyd5d.js

@@ -0,0 +1,380 @@
+#!/usr/bin/env node
+import { a as decodePointer, i as PointerTag, n as WORD_SIZE, r as ElementSize, t as Segment } from "./segment-yid_PYS5.js";
+import { readFileSync } from "node:fs";
+
+//#region src/cli-audit.ts
+/** 默认安全选项 */
+const DEFAULT_AUDIT_OPTIONS = {
+	maxSegments: 64,
+	maxTotalSize: 64 * 1024 * 1024,
+	strictMode: false
+};
+/**
+* Cap'n Proto 消息审计读取器
+* 用于安全审计消息文件
+*/
+var AuditReader = class {
+	segments;
+	options;
+	issues = [];
+	visitedPointers = /* @__PURE__ */ new Set();
+	pointersScanned = 0;
+	maxNestingDepth = 0;
+	constructor(buffer, options = {}) {
+		this.options = {
+			...DEFAULT_AUDIT_OPTIONS,
+			...options
+		};
+		const uint8Array = buffer instanceof ArrayBuffer ? new Uint8Array(buffer) : buffer;
+		this.segments = [];
+		if (uint8Array.byteLength < 8) {
+			this.addIssue("error", "invalid_header", "消息太小，无法包含有效的 Cap'n Proto 头部", "header", "消息至少需要8字节的头部");
+			return;
+		}
+		if (uint8Array.byteLength > this.options.maxTotalSize) {
+			this.addIssue("error", "size_exceeded", `消息大小(${uint8Array.byteLength}字节)超过最大限制(${this.options.maxTotalSize}字节)`, "header", "减小消息大小或增加 --max-size 限制");
+			if (this.options.strictMode) return;
+		}
+		const view = new DataView(uint8Array.buffer, uint8Array.byteOffset, uint8Array.byteLength);
+		const firstWordLow = view.getUint32(0, true);
+		const firstWordHigh = view.getUint32(4, true);
+		const segmentCount = (firstWordLow & 4294967295) + 1;
+		const firstSegmentSize = firstWordHigh;
+		if (segmentCount > this.options.maxSegments) {
+			this.addIssue("error", "segment_count_exceeded", `段数(${segmentCount})超过最大限制(${this.options.maxSegments})`, "header", "减少段数或增加 --max-segments 限制");
+			if (this.options.strictMode) return;
+		}
+		let offset = 8;
+		const segmentSizes = [firstSegmentSize];
+		for (let i = 1; i < segmentCount; i++) {
+			if (offset + 4 > uint8Array.byteLength) {
+				this.addIssue("error", "truncated_header", "段表在段大小信息之前结束", `header.segment[${i}]`, "消息文件可能已损坏");
+				return;
+			}
+			segmentSizes.push(view.getUint32(offset, true));
+			offset += 4;
+		}
+		offset = offset + 7 & -8;
+		if (offset > uint8Array.byteLength) {
+			this.addIssue("error", "truncated_header", "段表头部不完整", "header", "消息文件可能已损坏");
+			return;
+		}
+		let totalWords = 0;
+		for (let i = 0; i < segmentSizes.length; i++) {
+			const size = segmentSizes[i];
+			totalWords += size;
+			if (offset + size * WORD_SIZE > uint8Array.byteLength) {
+				this.addIssue("warning", "truncated_segment", `段${i}数据不足，声明大小:${size}字，实际可用:${Math.floor((uint8Array.byteLength - offset) / WORD_SIZE)}字`, `segment[${i}]`, "消息文件可能已损坏或被截断");
+				break;
+			}
+			const segmentBuffer = uint8Array.slice(offset, offset + size * WORD_SIZE);
+			this.segments.push(Segment.fromBuffer(segmentBuffer.buffer));
+			offset += size * WORD_SIZE;
+		}
+		if (totalWords > this.options.maxTotalSize / WORD_SIZE) this.addIssue("warning", "large_message", `消息总字数(${totalWords})较大，可能影响性能`, "message", "考虑分割大型消息");
+		this.scanAllPointers();
+	}
+	/**
+	* 添加审计问题
+	*/
+	addIssue(type, category, message, location, suggestion) {
+		this.issues.push({
+			type,
+			category,
+			message,
+			location,
+			suggestion
+		});
+	}
+	/**
+	* 获取段
+	*/
+	getSegment(index) {
+		return this.segments[index];
+	}
+	/**
+	* 扫描所有指针
+	*/
+	scanAllPointers() {
+		if (this.segments.length === 0) return;
+		for (let segIdx = 0; segIdx < this.segments.length; segIdx++) {
+			const segment = this.segments[segIdx];
+			const wordCount = segment.wordCount;
+			for (let wordIdx = 0; wordIdx < wordCount; wordIdx++) {
+				const ptrValue = segment.getWord(wordIdx);
+				if (ptrValue === 0n) continue;
+				this.scanPointer(segIdx, wordIdx, ptrValue, 0);
+			}
+		}
+	}
+	/**
+	* 扫描单个指针
+	*/
+	scanPointer(segmentIndex, wordOffset, ptrValue, depth) {
+		this.pointersScanned++;
+		this.maxNestingDepth = Math.max(this.maxNestingDepth, depth);
+		const ptrKey = `${segmentIndex}:${wordOffset}`;
+		if (this.visitedPointers.has(ptrKey)) {
+			this.addIssue("warning", "circular_reference", `检测到可能的循环引用 at segment[${segmentIndex}].word[${wordOffset}]`, `segment[${segmentIndex}].word[${wordOffset}]`, "检查消息结构是否存在循环");
+			return;
+		}
+		this.visitedPointers.add(ptrKey);
+		if (depth > 100) {
+			this.addIssue("error", "nesting_too_deep", "指针嵌套深度超过100，可能存在恶意构造的消息", `segment[${segmentIndex}].word[${wordOffset}]`, "检查消息是否被恶意构造");
+			return;
+		}
+		const ptr = decodePointer(ptrValue);
+		const segment = this.getSegment(segmentIndex);
+		if (!segment) return;
+		switch (ptr.tag) {
+			case PointerTag.STRUCT: {
+				const structPtr = ptr;
+				const targetOffset = wordOffset + 1 + structPtr.offset;
+				if (targetOffset < 0 || targetOffset + structPtr.dataWords + structPtr.pointerCount > segment.wordCount) this.addIssue("error", "out_of_bounds", `Struct指针目标超出段范围: offset=${structPtr.offset}, dataWords=${structPtr.dataWords}, pointerCount=${structPtr.pointerCount}`, `segment[${segmentIndex}].word[${wordOffset}]`, "消息可能已损坏或被篡改");
+				const pointerStart = targetOffset + structPtr.dataWords;
+				for (let i = 0; i < structPtr.pointerCount; i++) {
+					const ptrIdx = pointerStart + i;
+					if (ptrIdx < segment.wordCount) {
+						const nestedPtr = segment.getWord(ptrIdx);
+						if (nestedPtr !== 0n) this.scanPointer(segmentIndex, ptrIdx, nestedPtr, depth + 1);
+					}
+				}
+				break;
+			}
+			case PointerTag.LIST: {
+				const listPtr = ptr;
+				if (listPtr.elementSize === ElementSize.COMPOSITE) {
+					const tagOffset = wordOffset + 1 + listPtr.offset;
+					if (tagOffset >= 0 && tagOffset < segment.wordCount) {
+						const tagWord = segment.getWord(tagOffset);
+						const elementCount = Number(tagWord & BigInt(4294967295));
+						const dataWords = Number(tagWord >> BigInt(32) & BigInt(65535));
+						const pointerCount = Number(tagWord >> BigInt(48) & BigInt(65535));
+						if (elementCount > 1e6) this.addIssue("warning", "large_list", `复合列表元素数量异常: ${elementCount}`, `segment[${segmentIndex}].word[${wordOffset}]`, "检查列表大小是否合理");
+						const elementSize = dataWords + pointerCount;
+						const dataStart = tagOffset + 1;
+						for (let i = 0; i < elementCount; i++) for (let j = 0; j < pointerCount; j++) {
+							const ptrIdx = dataStart + i * elementSize + dataWords + j;
+							if (ptrIdx < segment.wordCount) {
+								const nestedPtr = segment.getWord(ptrIdx);
+								if (nestedPtr !== 0n) this.scanPointer(segmentIndex, ptrIdx, nestedPtr, depth + 1);
+							}
+						}
+					}
+				} else if (listPtr.elementSize === ElementSize.POINTER) {
+					const targetOffset = wordOffset + 1 + listPtr.offset;
+					for (let i = 0; i < listPtr.elementCount; i++) {
+						const ptrIdx = targetOffset + i;
+						if (ptrIdx < segment.wordCount) {
+							const nestedPtr = segment.getWord(ptrIdx);
+							if (nestedPtr !== 0n) this.scanPointer(segmentIndex, ptrIdx, nestedPtr, depth + 1);
+						}
+					}
+				}
+				break;
+			}
+			case PointerTag.FAR: {
+				const farPtr = ptr;
+				if (farPtr.targetSegment >= this.segments.length) this.addIssue("error", "invalid_far_pointer", `Far指针引用不存在的段: ${farPtr.targetSegment}`, `segment[${segmentIndex}].word[${wordOffset}]`, "消息可能已损坏");
+				else {
+					const targetSegment = this.getSegment(farPtr.targetSegment);
+					if (targetSegment && farPtr.targetOffset >= targetSegment.wordCount) this.addIssue("error", "invalid_far_pointer", `Far指针目标偏移超出范围: segment=${farPtr.targetSegment}, offset=${farPtr.targetOffset}`, `segment[${segmentIndex}].word[${wordOffset}]`, "消息可能已损坏");
+					if (farPtr.doubleFar) {
+						if (targetSegment && farPtr.targetOffset < targetSegment.wordCount) {
+							const landingPadPtr = targetSegment.getWord(farPtr.targetOffset);
+							if (landingPadPtr !== 0n) this.scanPointer(farPtr.targetSegment, farPtr.targetOffset, landingPadPtr, depth + 1);
+						}
+					}
+				}
+				break;
+			}
+			case PointerTag.OTHER:
+				this.addIssue("warning", "capability_in_message", "序列化消息中发现 Capability 或其他特殊指针", `segment[${segmentIndex}].word[${wordOffset}]`, "Capability 通常不应在序列化消息中");
+				break;
+		}
+	}
+	/**
+	* 生成审计报告
+	*/
+	generateReport(filePath, fileSize) {
+		const errors = this.issues.filter((i) => i.type === "error").length;
+		const warnings = this.issues.filter((i) => i.type === "warning").length;
+		const infos = this.issues.filter((i) => i.type === "info").length;
+		return {
+			filePath,
+			fileSize,
+			passed: errors === 0,
+			segmentCount: this.segments.length,
+			totalWords: this.segments.reduce((sum, s) => sum + s.wordCount, 0),
+			issues: this.issues,
+			summary: {
+				error: errors,
+				warning: warnings,
+				info: infos
+			},
+			pointersScanned: this.pointersScanned,
+			maxNestingDepth: this.maxNestingDepth
+		};
+	}
+};
+/**
+* 格式化审计报告为可读文本
+*/
+function formatAuditReport(report) {
+	const lines = [];
+	lines.push("=".repeat(60));
+	lines.push("CAP'N PROTO SECURITY AUDIT REPORT");
+	lines.push("=".repeat(60));
+	lines.push("");
+	lines.push("File Information:");
+	lines.push(`  Path: ${report.filePath}`);
+	lines.push(`  Size: ${report.fileSize.toLocaleString()} bytes`);
+	lines.push(`  Segments: ${report.segmentCount}`);
+	lines.push(`  Total Words: ${report.totalWords.toLocaleString()}`);
+	lines.push(`  Pointers Scanned: ${report.pointersScanned.toLocaleString()}`);
+	lines.push(`  Max Nesting Depth: ${report.maxNestingDepth}`);
+	lines.push("");
+	if (report.passed) lines.push("✅ AUDIT PASSED");
+	else lines.push("❌ AUDIT FAILED");
+	lines.push("");
+	lines.push("Summary:");
+	lines.push(`  Errors:   ${report.summary.error}`);
+	lines.push(`  Warnings: ${report.summary.warning}`);
+	lines.push(`  Info:     ${report.summary.info}`);
+	lines.push("");
+	if (report.issues.length > 0) {
+		lines.push("Issues:");
+		lines.push("-".repeat(60));
+		const errors = report.issues.filter((i) => i.type === "error");
+		const warnings = report.issues.filter((i) => i.type === "warning");
+		const infos = report.issues.filter((i) => i.type === "info");
+		if (errors.length > 0) {
+			lines.push("");
+			lines.push("❌ ERRORS:");
+			for (const issue of errors) {
+				lines.push(`  [${issue.category}] ${issue.message}`);
+				lines.push(`    Location: ${issue.location}`);
+				if (issue.suggestion) lines.push(`    💡 ${issue.suggestion}`);
+				lines.push("");
+			}
+		}
+		if (warnings.length > 0) {
+			lines.push("");
+			lines.push("⚠️  WARNINGS:");
+			for (const issue of warnings) {
+				lines.push(`  [${issue.category}] ${issue.message}`);
+				lines.push(`    Location: ${issue.location}`);
+				if (issue.suggestion) lines.push(`    💡 ${issue.suggestion}`);
+				lines.push("");
+			}
+		}
+		if (infos.length > 0) {
+			lines.push("");
+			lines.push("ℹ️  INFO:");
+			for (const issue of infos) {
+				lines.push(`  [${issue.category}] ${issue.message}`);
+				lines.push(`    Location: ${issue.location}`);
+				lines.push("");
+			}
+		}
+	} else lines.push("No issues found.");
+	lines.push("");
+	lines.push("=".repeat(60));
+	return lines.join("\n");
+}
+/**
+* 审计消息文件
+*/
+function auditMessageFile(filePath, options = {}) {
+	const buffer = readFileSync(filePath);
+	return new AuditReader(buffer, options).generateReport(filePath, buffer.byteLength);
+}
+const CLI_VERSION = "0.9.0";
+function printUsage() {
+	console.log(`
+Cap'n Proto Security Audit CLI v${CLI_VERSION}
+
+Usage: capnp audit <file> [options]
+
+Arguments:
+  file          Path to Cap'n Proto message binary file
+
+Options:
+  --strict              Strict mode, fail on warnings
+  --json                Output as JSON
+  -o, --output <file>   Write report to file
+  --max-segments <n>    Maximum allowed segments (default: 64)
+  --max-size <bytes>    Maximum message size in bytes (default: 64MB)
+  -h, --help            Show this help
+
+Examples:
+  capnp audit message.bin
+  capnp audit message.bin --strict
+  capnp audit message.bin --json -o report.json
+  capnp audit message.bin --max-segments 128 --max-size 134217728
+`);
+}
+function parseArgs(args) {
+	const options = {};
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "-h" || arg === "--help") {
+			printUsage();
+			process.exit(0);
+		}
+		if (arg === "--strict") options.strict = true;
+		else if (arg === "--json") options.json = true;
+		else if (arg === "-o" || arg === "--output") options.output = args[++i];
+		else if (arg === "--max-segments") {
+			const val = Number.parseInt(args[++i], 10);
+			if (Number.isNaN(val) || val <= 0) {
+				console.error("Error: --max-segments must be a positive integer");
+				process.exit(1);
+			}
+			options.maxSegments = val;
+		} else if (arg === "--max-size") {
+			const val = Number.parseInt(args[++i], 10);
+			if (Number.isNaN(val) || val <= 0) {
+				console.error("Error: --max-size must be a positive integer");
+				process.exit(1);
+			}
+			options.maxSize = val;
+		} else if (!arg.startsWith("-")) {
+			if (!options.file) options.file = arg;
+		}
+	}
+	return options;
+}
+async function run(args) {
+	const options = parseArgs(args);
+	if (!options.file) {
+		console.error("Error: File path is required");
+		printUsage();
+		process.exit(1);
+	}
+	try {
+		const auditOptions = {
+			strictMode: options.strict,
+			maxSegments: options.maxSegments,
+			maxTotalSize: options.maxSize
+		};
+		const report = auditMessageFile(options.file, auditOptions);
+		let output;
+		if (options.json) output = JSON.stringify(report, null, 2);
+		else output = formatAuditReport(report);
+		if (options.output) {
+			const { writeFileSync } = await import("node:fs");
+			writeFileSync(options.output, output, "utf-8");
+			console.log(`Report written to: ${options.output}`);
+		} else console.log(output);
+		const shouldFail = !report.passed || options.strict && report.summary.warning > 0;
+		process.exit(shouldFail ? 1 : 0);
+	} catch (err) {
+		console.error("Error:", err instanceof Error ? err.message : err);
+		process.exit(2);
+	}
+}
+
+//#endregion
+export { run };
+//# sourceMappingURL=cli-audit-j58Eyd5d.js.map