@dzhechkov/cloudru-hub 0.1.14 → 0.1.16

package/docs/cost-compare.example.json

@@ -0,0 +1,84 @@
+{
+  "schemaVersion": 1,
+  "horizonHours": "24",
+  "currency": "RUB",
+  "vatBasis": "included",
+  "workload": {
+    "replicas": 3,
+    "cpuPerReplica": "1",
+    "ramGBPerReplica": "1",
+    "survivingReplicas": 2,
+    "failedNodes": 1
+  },
+  "equivalence": {
+    "status": "unknown",
+    "reason": "Application placement, availability and performance equivalence have not been verified.",
+    "assumptions": ["Both scenarios run the same three replicas for the full 24-hour horizon."]
+  },
+  "scenarios": [
+    {
+      "id": "vm",
+      "kind": "vm",
+      "nodes": { "count": 3, "cpu": "2", "ramGB": "4", "reservedCpu": "0", "reservedRamGB": "0", "cpuShare": "1" },
+      "controlPlaneCount": 0,
+      "resources": { "storageGB": "60", "publicIpCount": 3, "snatGatewayCount": 0, "loadBalancerCount": 0, "trafficGB": null },
+      "categories": {
+        "compute": { "status": "priced", "items": [{
+          "id": "vm-2cpu-4gb", "description": "Three active 2vCPU/4GB VM instances",
+          "quantity": "3", "unit": "instance-hour", "rateRub": "2.9707",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/evolution-compute.pdf", "version": "261014", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "VM 2vCPU/4GB row 18", "sha256": "a459226e73c8db4dc650307f3f07d99d9f17be31e0e22cd65c7a360dc1685dc5" }
+        }] },
+        "controlPlane": { "status": "not-used", "reason": "VM scenario has no separately billed control-plane service." },
+        "storage": { "status": "priced", "items": [{
+          "id": "ssd-60gb", "description": "Assumed 60GB billed SSD allocation across the VM scenario",
+          "quantity": "60", "unit": "GB-hour", "rateRub": "0.01586",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/evolution-compute.pdf", "version": "261014", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "SSD row 85", "sha256": "a459226e73c8db4dc650307f3f07d99d9f17be31e0e22cd65c7a360dc1685dc5" }
+        }] },
+        "publicIp": { "status": "priced", "items": [{
+          "id": "vm-public-ip", "description": "Three assumed active public IP allocations",
+          "quantity": "3", "unit": "IP-hour", "rateRub": "0.2074",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/evolution-compute.pdf", "version": "261014", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "Public IP row 2", "sha256": "a459226e73c8db4dc650307f3f07d99d9f17be31e0e22cd65c7a360dc1685dc5" }
+        }] },
+        "snat": { "status": "not-used", "reason": "No SNAT gateway is declared in this VM scenario." },
+        "loadBalancer": { "status": "not-used", "reason": "No load balancer is declared; direct public IP exposure is assumed." },
+        "traffic": { "status": "unpriced", "reason": "Traffic quantity and applicable tariff are unknown; do not assume zero traffic cost." }
+      }
+    },
+    {
+      "id": "k8s",
+      "kind": "k8s",
+      "nodes": { "count": 3, "cpu": "2", "ramGB": "4", "reservedCpu": "0", "reservedRamGB": "0", "cpuShare": "1" },
+      "controlPlaneCount": 1,
+      "resources": { "storageGB": "80", "publicIpCount": 2, "snatGatewayCount": 1, "loadBalancerCount": 0, "trafficGB": null },
+      "categories": {
+        "compute": { "status": "priced", "items": [{
+          "id": "worker-2cpu-4gb", "description": "Three active 2vCPU/4GB Kubernetes workers",
+          "quantity": "3", "unit": "instance-hour", "rateRub": "2.9768",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/managed-kubernetes.pdf", "version": "260918", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "Worker 2vCPU/4GB row 6", "sha256": "5493f6da595b67482277ca420512db8f7f953375536a6169db8d1b282f24f345" }
+        }] },
+        "controlPlane": { "status": "priced", "items": [{
+          "id": "zonal-master", "description": "One billed zonal control-plane service instance",
+          "quantity": "1", "unit": "instance-hour", "rateRub": "8.601",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/managed-kubernetes.pdf", "version": "260918", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "Zonal master 2vCPU/4GB row 42", "sha256": "5493f6da595b67482277ca420512db8f7f953375536a6169db8d1b282f24f345" }
+        }] },
+        "storage": { "status": "priced", "items": [{
+          "id": "ssd-80gb", "description": "Assumed 80GB billed SSD allocation across the Kubernetes scenario",
+          "quantity": "80", "unit": "GB-hour", "rateRub": "0.01586",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/managed-kubernetes.pdf", "version": "260918", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "SSD row 39", "sha256": "5493f6da595b67482277ca420512db8f7f953375536a6169db8d1b282f24f345" }
+        }] },
+        "publicIp": { "status": "priced", "items": [{
+          "id": "k8s-public-ip", "description": "Two assumed active public IP allocations",
+          "quantity": "2", "unit": "IP-hour", "rateRub": "0.2074",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/managed-kubernetes.pdf", "version": "260918", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "Public IP row 40", "sha256": "5493f6da595b67482277ca420512db8f7f953375536a6169db8d1b282f24f345" }
+        }] },
+        "snat": { "status": "priced", "items": [{
+          "id": "public-snat", "description": "One assumed active public SNAT gateway",
+          "quantity": "1", "unit": "gateway-hour", "rateRub": "0.2074",
+          "tariff": { "url": "https://cdn.cloud.ru/docs/legal/tariffs/evolution/current-version/evolution-compute.pdf", "version": "261014", "asOf": "2026-10-21", "vatBasis": "included", "pageOrRow": "Public SNAT row 3", "sha256": "a459226e73c8db4dc650307f3f07d99d9f17be31e0e22cd65c7a360dc1685dc5" }
+        }] },
+        "loadBalancer": { "status": "not-used", "reason": "No load balancer is declared; the assumed application architecture avoids it." },
+        "traffic": { "status": "unpriced", "reason": "Traffic quantity and applicable tariff are unknown; do not assume zero traffic cost." }
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/cloudru-hub",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "licenseHold": {
     "adr": "features/hermes-claude-adaptation/03_adr/001-licence-and-provenance-precondition.md",
     "note": "SATISFIED hold. Timur is credited for substantial Cloud.ru API testing. The 2026-10-20 correction is in the historical grant record. This field keeps the dz guard licence-hold rule checking LICENSE, THIRD_PARTY_NOTICES and SPDX on every publish."
@@ -26,9 +26,9 @@
   ],
   "cloudruHub": {
     "binaryHashes": {
-      "linux-x64": "4463b09323c9dfe0c32d618d335734a947e7fab0a75d07a7bea089b97a97c9b6"
+      "linux-x64": "94fdba4fe4d1a71e684be998c3d2f94f374ff4e4054db2683bcc04d72bfabc03"
     },
-    "engineVersion": "cloudru-vm 0.2.6-20261020",
+    "engineVersion": "cloudru-vm 0.2.7-20261029",
     "platformPackages": {
       "linux-x64": "@dzhechkov/cloudru-vm-linux-x64"
     }
@@ -53,15 +53,12 @@
     "yaml": "^2.9.0"
   },
   "optionalDependencies": {
-    "@dzhechkov/cloudru-vm-linux-x64": "0.2.6"
-  },
-  "scripts": {
-    "test": "node --test 'test/*.test.mjs'"
+    "@dzhechkov/cloudru-vm-linux-x64": "0.2.7"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/djd1m/dz-harness.git",
-    "directory": "packages/@dzhechkov/cloudru-hub"
+    "directory": "packages/cloudru-hub"
   },
   "homepage": "https://aicoding.space",
   "bugs": {
@@ -69,5 +66,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "test": "node --test 'test/*.test.mjs'"
   }
-}
+}

package/sbom.json

@@ -15,7 +15,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "4d6d0e6f47b09b017a32e4f3287c0669821e61569835c397245e5077435f5b15"
+          "content": "56ba17ee84afe937d3f13c17387b26090e42217b1c8ffd9eee175a5512a14091"
         }
       ]
     },
@@ -35,7 +35,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "2c25bbd9659f1a02e2a7a5413de8673e8735d67e583458fdede75dfd032b6106"
+          "content": "bfd1c00de39c986cebad2e3fb00fa072ad0b4ecb3cb07f744920bf80474ecb47"
         }
       ]
     },
@@ -75,7 +75,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "6f4557d97b90936ef153dc90eac4bdceb6846b6d08d8aec45c86baac328cca60"
+          "content": "32845b9cc1ad64f2f6a8d4eeb8b90bf36710590d25db4234e6813793ef63c5d4"
         }
       ]
     },
@@ -85,7 +85,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "9abb3ca6347b0cd6cd51b23649c59e0a0c816e6c12a325f573b392affa350d0b"
+          "content": "a4bf5a2e76d4f9bd686bec704919ab3380bb22ff46a399b058dc5b3e71a64dd1"
         }
       ]
     },
@@ -95,7 +95,17 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "dff98bb859dfbbf8ed2fb6f16f17b767444cc2172ecc7684ca3df8188c95707c"
+          "content": "6864bb944ebf780454d266fe7ad47e9cec12969fb66fa9e9a1963b547944e10f"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "docs/COST-COMPARE.md",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "80b4d7ac3868f17d93565274cd6736fe5f2bd7fb059cbed0c2f0afe3f4924317"
         }
       ]
     },
@@ -105,7 +115,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "3605797972f9a7c79c13fbcce0cd9ac8b8fb3a8249abbab938f2b1a45f515420"
+          "content": "00a5c9acc3999c5e07f230ba63bc1a0e202d62c8d15d2204620feca762eece8f"
         }
       ]
     },
@@ -115,7 +125,27 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "de6f709e820fbb831f390e274238b28ba938644670a8db04fd50d1fa0d86da75"
+          "content": "7f5cc32d5f089c66246f8349f86fc72dfe6397de7a63edf51692da8583231b41"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "docs/WEB-IMAGE.md",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "690e092bafddc862c20ebd5ff0358a4c57f84881153c235a146e258563459f27"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "docs/cost-compare.example.json",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "7eafb1ff555fb5443ded1a2c578b17eae6e73e3056efb9cbb5129b424c8c5097"
         }
       ]
     },
@@ -129,7 +159,7 @@
         },
         {
           "name": "dz:canonical-json-sha256-v2",
-          "value": "d906ed1871af834274d77dbd3a345b168604456b15360f009a9474778273b11f"
+          "value": "94247888df4287a6077204c369ccb685a51b1d943635d51c6228dc1f8fe54635"
         }
       ]
     },
@@ -149,7 +179,17 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "a22f3fcced6e9970e7bed6b935fc03637b6d4b8d3cd6cc65a2685595a6549c1c"
+          "content": "590265903b3a242b3d9c1367801ce6ce10e23e18abbc28938c5a26f735ea7d75"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "src/cost-compare.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "6084ecd7f7fc53bbd441fb9e91dcd7c7bd5c409d1d4e95613fad0fd0735b7b05"
         }
       ]
     },
@@ -189,7 +229,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "c928db48febfb4a79884ce1830365a8302122a55fb5d6ada8e771c049396ca89"
+          "content": "90af414aabda1c48c82c9c2ecf0dbe4d7dd4744486efdce0d8367182b6a67a38"
         }
       ]
     },
@@ -199,7 +239,17 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "014c2effd1e843d870ae1af4f93f5c82faff9972e9f6ca028ed39d47ec33ee3a"
+          "content": "950543b85a7ed2c8e1660b40c2bb50192663e5fe62f8287b9b76ac3f8178c263"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "src/k8s-image-manifest.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "8a2c519e9bc6677c867758f4b9b56146f2832ee07a5bfd4fefed3317f0d9cf73"
         }
       ]
     },
@@ -229,7 +279,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "4f95cfb9576c411232503b26053ece6d8d186e4b337beff9bd4afd249f74a014"
+          "content": "60a5db44db9518835f98f23aa104b86c3621f0b0c030196c2130715f5c19c219"
         }
       ]
     },
@@ -239,7 +289,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "89229c882b6a3f5bb9ee542b31d1a40374b91879747582a3e82e8aadc72decb3"
+          "content": "0a66e73476d5f5624908f05f621b150efa51217fc9418938ca126dc0dc2b9518"
         }
       ]
     },
@@ -269,7 +319,17 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "026e3031180ce9227b4d31775b9c886b10ad0cb418ed0754aed75b12ded84e31"
+          "content": "413ddf6d9a4f709d80bce9011094d95bbe56f12c391f72be235c4482a1b40450"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "test/cost-compare.test.mjs",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "b354913220bf725ec6b8a708b7851e2f5779a3c594cd411732d19acad9001870"
         }
       ]
     },
@@ -279,7 +339,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "d72e4363fd50d0fcc65fd23b40601516bd73368c3659f2a55a394c4d1ed3f85c"
+          "content": "3aaf3cdf27c57be9121d7d1727335d0a97064659b3201d34d1e27f5aed631434"
         }
       ]
     },
@@ -319,7 +379,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "af04d1941fb7aed2cc51b05f65ffed1c440d4d23a7fb26e13261d45e07b0a1f8"
+          "content": "acc30164bbafc2d46b404ff8ae87caf42e301e15dd005c424654ee0225af6efd"
         }
       ]
     },
@@ -359,7 +419,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "9ad83ba418dee86ef680575a0cc7da4af4be3ae995c00f23f84b336838fbda47"
+          "content": "b447a8755c67bcbfc3db63c909235f34414721139c7bc7fdf0658ab0638e7980"
         }
       ]
     },
@@ -369,7 +429,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "45406dabeee0635ede5cda3d2f4144c5c13886d624287fd223b01252d2859b87"
+          "content": "e99200ccdd8368260af18532478addc08e3b6195986cecf68b669e9dc639d119"
         }
       ]
     }

package/src/cli.js

@@ -3,14 +3,21 @@
 // Zero dependencies, CommonJS, boots from any cwd (dz release smoke contract).
 
 const { spawn, spawnSync } = require('child_process');
-const { resolveEngine } = require('./resolve');
-const { loadClassification, loadSnapshot, coverageGaps } = require('./classification');
-const { install } = require('./install');
-const { runSafeMcp } = require('./safe-mcp');
-const { issueApproval } = require('./deploy-approval');
-const { issueK8sApproval } = require('./k8s-approval');
-const { compileSkill, writeCompiled } = require('./dialects');
 const PKG = require('../package.json');
+let resolveEngine, loadClassification, loadSnapshot, coverageGaps, install, runSafeMcp;
+let issueApproval, issueK8sApproval, compileSkill, writeCompiled;
+let legacyLoaded = false;
+function loadLegacyCommands() {
+  if (legacyLoaded) return;
+  ({ resolveEngine } = require('./resolve'));
+  ({ loadClassification, loadSnapshot, coverageGaps } = require('./classification'));
+  ({ install } = require('./install'));
+  ({ runSafeMcp } = require('./safe-mcp'));
+  ({ issueApproval } = require('./deploy-approval'));
+  ({ issueK8sApproval } = require('./k8s-approval'));
+  ({ compileSkill, writeCompiled } = require('./dialects'));
+  legacyLoaded = true;
+}
 
 function showHelp(write) {
   write(`cloudru-hub ${PKG.version} — unofficial Cloud.ru Evolution launcher (NOT affiliated with Cloud.ru)
@@ -31,7 +38,10 @@ Commands:
                            Authorize one exact VM plan for ten minutes within a RUB/month cap.
                            Static sites require the artifact digest shown by deploy_plan.
   k8s-approve --cluster-id <uuid> --namespace <name> --manifest <file> --manifest-sha256 <digest>
-                           Authorize one exact three-resource Snake manifest on an existing cluster.
+              [--profile snake|web-image]
+                           Authorize one exact bounded manifest on an existing cluster.
+  cost-compare --input <json> [--json]
+                           Offline VM vs Kubernetes cost worksheet; no engine or credentials.
   install --target <t>     claude-code: permissions + executed hook probe;
                            codex|opencode|pi: project MCP config using mcp-safe;
                            hermes: guarded $HERMES_HOME/config.yaml entry using mcp-safe;
@@ -139,6 +149,9 @@ function cmdMcp() {
 }
 
 function main(argv, write = (s) => process.stdout.write(s + '\n')) {
+  // This command validates its raw flags before the permissive legacy parser sees them.
+  if (argv[0] === 'cost-compare') return require('./cost-compare').run(argv.slice(1), write);
+  loadLegacyCommands();
   const { flags, opts, positional } = parseArgs(argv);
   const cmd = positional[0] || 'help';
   if (flags.has('help') || flags.has('h') || cmd === 'help') { showHelp(write); return 0; }
@@ -178,7 +191,7 @@ function main(argv, write = (s) => process.stdout.write(s + '\n')) {
     case 'k8s-approve': {
       try {
         const approval = issueK8sApproval(opts.get('cluster-id'), opts.get('namespace'),
-          opts.get('manifest'), opts.get('manifest-sha256'));
+          opts.get('manifest'), opts.get('manifest-sha256'), process.env, Date.now(), opts.get('profile') || 'snake');
         write(flags.has('json') ? JSON.stringify(approval, null, 2) :
           `approved ${approval.approvalId}: cluster ${approval.clusterId}, namespace ${approval.namespace}, SHA-256 ${approval.manifestSha256}; expires ${new Date(approval.expiresAt).toISOString()}`);
         return 0;