@xnetjs/cli 0.0.2

package/dist/index.d.ts

@@ -0,0 +1,120 @@
+import { Schema } from '@xnetjs/data';
+
+/**
+ * Schema Diff Utility - Compare two schema versions and identify changes.
+ *
+ * This utility analyzes the differences between two schema definitions
+ * and classifies changes by risk level for migration planning.
+ *
+ * @example
+ * ```typescript
+ * const changes = diffSchemas(oldSchema, newSchema)
+ * for (const change of changes) {
+ *   console.log(`${change.risk}: ${change.description}`)
+ * }
+ * ```
+ */
+
+/**
+ * Extended property definition that includes optional select options.
+ * This is a superset of the base PropertyDefinition from @xnetjs/data
+ * to handle select/multiSelect options which may be stored in config or directly.
+ */
+interface ExtendedPropertyDefinition {
+    '@id': string;
+    name: string;
+    type: string;
+    required: boolean;
+    config?: Record<string, unknown>;
+    /** Select options (may be in config or directly on definition) */
+    options?: Array<{
+        value: string;
+        label?: string;
+    }>;
+}
+type SchemaChangeType = 'add' | 'remove' | 'modify' | 'rename';
+type RiskLevel = 'safe' | 'caution' | 'breaking';
+/**
+ * A single change between two schema versions.
+ */
+interface SchemaChange {
+    /** Type of change */
+    type: SchemaChangeType;
+    /** Property name (or old name for renames) */
+    property: string;
+    /** New property name (for renames) */
+    newProperty?: string;
+    /** Risk level of this change */
+    risk: RiskLevel;
+    /** Human-readable description */
+    description: string;
+    /** Suggested lens operation (if applicable) */
+    suggestedLens?: string;
+    /** Old property definition (for modifications/removals) */
+    oldDefinition?: ExtendedPropertyDefinition;
+    /** New property definition (for additions/modifications) */
+    newDefinition?: ExtendedPropertyDefinition;
+}
+/**
+ * Result of schema comparison.
+ */
+interface SchemaDiffResult {
+    /** Old schema version */
+    fromVersion: string;
+    /** New schema version */
+    toVersion: string;
+    /** List of changes detected */
+    changes: SchemaChange[];
+    /** Overall risk level (highest of all changes) */
+    overallRisk: RiskLevel;
+    /** Whether automatic migration is possible */
+    autoMigratable: boolean;
+    /** Summary of changes by category */
+    summary: {
+        safe: number;
+        caution: number;
+        breaking: number;
+    };
+}
+/**
+ * Compare two schema versions and identify all changes.
+ *
+ * @param oldSchema - The source schema version
+ * @param newSchema - The target schema version
+ * @returns Detailed diff result with changes and risk assessment
+ */
+declare function diffSchemas(oldSchema: Schema, newSchema: Schema): SchemaDiffResult;
+
+/**
+ * Lens Code Generator - Generate migration lens code from schema diff.
+ *
+ * This utility generates TypeScript code for schema migration lenses
+ * based on the detected changes between two schema versions.
+ */
+
+interface GenerateLensOptions {
+    /** The schema diff result */
+    diff: SchemaDiffResult;
+    /** Source schema IRI */
+    sourceIRI: string;
+    /** Target schema IRI */
+    targetIRI: string;
+    /** Whether to include comments */
+    includeComments?: boolean;
+    /** Whether to include TODO markers for manual fixes */
+    includeTodos?: boolean;
+}
+interface GeneratedLens {
+    /** The generated TypeScript code */
+    code: string;
+    /** Whether the generated lens is complete (no TODOs) */
+    isComplete: boolean;
+    /** List of items that need manual attention */
+    manualItems: string[];
+}
+/**
+ * Generate migration lens code from a schema diff.
+ */
+declare function generateLensCode(options: GenerateLensOptions): GeneratedLens;
+
+export { type GenerateLensOptions, type RiskLevel, type SchemaChange, type SchemaChangeType, diffSchemas, generateLensCode };

package/dist/index.js

@@ -0,0 +1,8 @@
+import {
+  diffSchemas,
+  generateLensCode
+} from "./chunk-IUOECMVU.js";
+export {
+  diffSchemas,
+  generateLensCode
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@xnetjs/cli",
+  "version": "0.0.2",
+  "description": "xNet CLI - Schema migrations, diagnostics, and development tools",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crs48/xNet"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "xnet": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "@xnetjs/data": "0.0.2",
+    "@xnetjs/sync": "0.0.2"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsup src/index.ts src/cli.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}