kuhul-es 1.0.11 → 1.0.13

package/bin/kuhul-es.js

@@ -1,79 +1,160 @@
 #!/usr/bin/env node
 'use strict';
 
-// KUHUL-ES CLI
-
+/*
+ * KUHUL-ES CLI
+ * v1.0.12 — Version Integrity + Trace Artifact
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
 const { program } = require('commander');
 
+// -----------------------------------------------------------------------------
+// Version (single source of truth)
+// -----------------------------------------------------------------------------
+const pkg = require('../package.json');
+
+// -----------------------------------------------------------------------------
+// Banner
+// -----------------------------------------------------------------------------
 console.log(`
 ╔══════════════════════════════════════╗
-║        KUHUL-ES v1.0.10               ║
+║        KUHUL-ES v${pkg.version}               ║
 ║  ECMAScript syntax, KUHUL semantics  ║
 ╚══════════════════════════════════════╝
 `);
 
+// -----------------------------------------------------------------------------
+// CLI Definition
+// -----------------------------------------------------------------------------
 program
   .name('kuhul-es')
   .description('KUHUL-ES - The Trojan Horse for KUHUL semantics')
-  .version('1.0.8');
+  .version(pkg.version);
 
+// -----------------------------------------------------------------------------
+// init
+// -----------------------------------------------------------------------------
 program
   .command('init [project-name]')
   .description('Initialize a new KUHUL-ES project')
   .action((projectName = 'my-kuhul-app') => {
     console.log(`Creating project: ${projectName}`);
+    process.exit(0);
   });
 
+// -----------------------------------------------------------------------------
+// compile
+// -----------------------------------------------------------------------------
 program
   .command('compile <file>')
   .description('Compile KUHUL-ES source file')
   .action((file) => {
     console.log(`Compiling: ${file}`);
+    process.exit(0);
   });
 
+// -----------------------------------------------------------------------------
+// run
+// -----------------------------------------------------------------------------
 program
   .command('run <file>')
   .description('Run a KUHUL-ES program')
   .option('--record', 'Record deterministic execution trace')
-  .option('--replay <hash>', 'Replay from a recorded trace')
+  .option('--replay <trace>', 'Replay from a recorded trace file')
   .action((file, options) => {
     console.log(`▶ Running: ${file}`);
-    if (options.record) console.log('⏺ Recording execution');
-    if (options.replay) console.log(`⏮ Replaying ${options.replay}`);
+
+    // -------------------------------------------------------------------------
+    // RECORD
+    // -------------------------------------------------------------------------
+    if (options.record) {
+      console.log('⏺ Recording execution');
+
+      const trace = {
+        version: pkg.version,
+        file,
+        argv: process.argv.slice(2),
+        cwd: process.cwd(),
+        timestamp: new Date().toISOString()
+      };
+
+      trace.hash = crypto
+        .createHash('sha256')
+        .update(JSON.stringify(trace))
+        .digest('hex');
+
+      const outPath = path.resolve(process.cwd(), 'trace.json');
+      fs.writeFileSync(outPath, JSON.stringify(trace, null, 2));
+
+      console.log(`📄 trace.json written`);
+      console.log(`🔑 trace hash: ${trace.hash}`);
+    }
+
+    // -------------------------------------------------------------------------
+    // REPLAY
+    // -------------------------------------------------------------------------
+    if (options.replay) {
+      console.log(`⏮ Replaying ${options.replay}`);
+
+      const replayPath = path.resolve(process.cwd(), options.replay);
+      const trace = JSON.parse(fs.readFileSync(replayPath, 'utf8'));
+
+      const expectedHash = crypto
+        .createHash('sha256')
+        .update(JSON.stringify({
+          ...trace,
+          hash: undefined
+        }))
+        .digest('hex');
+
+      if (trace.hash !== expectedHash) {
+        console.error('✗ Trace hash mismatch');
+        process.exit(1);
+      }
+
+      console.log(`✓ Trace verified`);
+      console.log(`🔑 trace hash: ${trace.hash}`);
+    }
+
     console.log('✓ Execution complete (stub)');
+    process.exit(0);
   });
 
+// -----------------------------------------------------------------------------
+// doctor
+// -----------------------------------------------------------------------------
 program
   .command('doctor')
   .description('Run environment diagnostics for KUHUL-ES')
   .action(() => {
     console.log('🩺 KUHUL-ES Doctor\n');
 
-    // Node version
+    console.log('Version:', pkg.version);
     console.log('Node:', process.version);
-
-    // Platform
     console.log('Platform:', process.platform);
-
-    // CLI location
     console.log('CLI path:', __filename);
+    console.log('CWD:', process.cwd());
 
-    // Commander check
     try {
       require.resolve('commander');
       console.log('Commander: OK');
     } catch {
       console.log('Commander: MISSING');
+      process.exit(1);
     }
 
-    // Working directory
-    console.log('CWD:', process.cwd());
-
     console.log('\n✓ Diagnostics complete');
+    process.exit(0);
   });
 
+// -----------------------------------------------------------------------------
+// Parse
+// -----------------------------------------------------------------------------
 program.parse(process.argv);
 
 if (!process.argv.slice(2).length) {
   program.outputHelp();
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kuhul-es",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "main": "src/index.js",
   "bin": {
     "kuhul-es": "bin/kuhul-es.js"