@everfur/cli 0.1.0 → 0.2.1

package/dist/index.js

@@ -1,22 +1,3 @@
 #!/usr/bin/env node
-export { COMMANDS, ExitCode, REASON_CODES, buildDiagnosisDocument, buildExplanationDocument, buildSandboxDocument, buildVerificationDocument, editDistance, failureOutcome, formatOutcome, isKnownReasonCode, matchCommand, nextActionFor2 as nextActionForErrorCode, nextActionFor as nextActionForReason, nextActionsFor, parseCapabilities, parseDiagnostics, parseIdentityMode, parseSessionMintLanguage, parseSuppliedFacts, projectSandboxCreate, renderDiagnosis, renderExplanation, renderPlan, renderSandboxCreate, renderVerification, runCli, suggestCodes } from './chunk-67H43MI6.js';
-export { ADMIN_TOKEN, API_PREFIX, BASE_URL_ENV_VAR, CLI_VERSION, CREDENTIAL_SPECS, DEFAULT_TIMEOUT_MS, EMPTY_REGISTRY, ERRORS_DOCUMENT_KEY, IDEMPOTENT_METHODS, MISSING_FACT_NAMES, PARTNER_KEY, PARTNER_SECRET_KEY, PLAN_DOCUMENT_KIND, PLAN_SCHEMA_VERSION, REDACTED, SCHEMAS, SESSION_TOKEN, TransportError, apiUrl, buildDecisionSpace, clampTimeout, createApiClient, createRecordingClock, describeFailure, detectProject, digestOfProjection, digestsEqual, entryFromRow, ephemeralCredential, errorCodeOf, failureDetails, fetchTransport, isCorrelatableRequestId, isIdempotent, loadDecisionSpace, loadErrorRegistry, missingFactsFor, nodeFileSystem, planIntegration, resolveContractPath, resolveCredential, resolveEndpoint, runVerification, systemClock, validateContractFile, validateContractPublicEnvelope, validateDiagnosisDocument, validateErrorExplanationDocument, validatePlanDocument, validateSandboxCreateDocument, validateVerificationDocument, verifyDigest, walkSingle, walkTree, withPrefix } from './chunk-KQZ6ZXL7.js';
-
-// src/fs/memory-fs.ts
-function createMemoryFileSystem(files) {
-  const table = new Map(Object.entries(files));
-  const directories = /* @__PURE__ */ new Set();
-  for (const path of table.keys()) {
-    const segments = path.split("/");
-    for (let index = 1; index < segments.length; index += 1) {
-      directories.add(segments.slice(0, index).join("/"));
-    }
-  }
-  return Object.freeze({
-    readFile: (path) => table.get(path) ?? null,
-    exists: (path) => table.has(path) || directories.has(path),
-    isDirectory: (path) => directories.has(path) && !table.has(path)
-  });
-}
-
-export { createMemoryFileSystem };
+export { COMMANDS, buildSandboxDocument, buildVerificationDocument, failureOutcome, formatOutcome, matchCommand, nextActionsFor, parseCapabilities, parseIdentityMode, parseSessionMintLanguage, parseSuppliedFacts, projectSandboxCreate, renderDiagnosis, renderPlan, renderSandboxCreate, renderVerification, runCli } from './chunk-4UB26D67.js';
+export { ADMIN_TOKEN, API_PREFIX, BASE_URL_ENV_VAR, CLI_VERSION, CREDENTIAL_SPECS, DEFAULT_TIMEOUT_MS, EMPTY_REGISTRY, ERRORS_DOCUMENT_KEY, ExitCode, IDEMPOTENT_METHODS, MISSING_FACT_NAMES, PARTNER_KEY, PARTNER_SECRET_KEY, PLAN_DOCUMENT_KIND, PLAN_SCHEMA_VERSION, REASON_CODES, REDACTED, SCHEMAS, SESSION_TOKEN, THEME_TOKEN_ORDER, TransportError, apiUrl, buildDecisionSpace, buildDiagnosisDocument, buildExplanationDocument, clampTimeout, createApiClient, createMemoryFileSystem, createRecordingClock, describeFailure, detectProject, detectTheme, detectThemeFromText, digestOfProjection, digestsEqual, editDistance, entryFromRow, ephemeralCredential, errorCodeOf, failureDetails, fetchTransport, isCorrelatableRequestId, isIdempotent, isKnownReasonCode, loadDecisionSpace, loadErrorRegistry, missingFactsFor, nextActionFor2 as nextActionForErrorCode, nextActionFor as nextActionForReason, nodeFileSystem, parseDiagnostics, planIntegration, renderExplanation, resolveContractPath, resolveCredential, resolveEndpoint, runVerification, suggestCodes, systemClock, validateContractFile, validateContractPublicEnvelope, validateDiagnosisDocument, validateErrorExplanationDocument, validatePlanDocument, validateSandboxCreateDocument, validateVerificationDocument, verifyDigest, walkSingle, walkTree, withPrefix } from './chunk-KQICUK54.js';

package/package.json

@@ -1,19 +1,20 @@
 {
   "name": "@everfur/cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Everfur CLI: plan, verify, and diagnose an Everfur pet-health integration from the terminal.",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
   "bin": {
     "everfur": "./dist/everfur.js",
-    "everfur-mcp": "./dist/everfur-mcp.js"
+    "everfur-mcp": "./dist/everfur-mcp.js",
+    "everfur-mcp-http": "./dist/everfur-mcp-http.js",
+    "everfur-mcp-hosted": "./dist/everfur-mcp-hosted.js"
   },
   "files": [
     "dist",
     "!dist/**/*.map",
-    "schema",
-    "contract"
+    "schema"
   ],
   "publishConfig": {
     "access": "public"

package/schema/diagnosis.v1.schema.json

@@ -106,6 +106,10 @@
     "capabilities": {
       "type": "array",
       "items": { "$ref": "#/$defs/CapabilityDiagnosis" }
+    },
+    "switches": {
+      "description": "Additive to v1. Every partner switch the diagnostics response reported, in the order sent and under its own name. Null when the deployment sent no switches block (one older than it); an empty array is a deployment that reports switches and has none. Optional: a document from a CLI older than this field omits it.",
+      "oneOf": [{ "type": "null" }, { "type": "array", "items": { "$ref": "#/$defs/SwitchDiagnosis" } }]
     }
   },
   "$defs": {
@@ -161,6 +165,43 @@
           "minLength": 1
         }
       }
+    },
+    "SwitchDiagnosis": {
+      "type": "object",
+      "required": ["name", "enabled", "kind", "gates", "tenantTerm", "reason", "nextAction"],
+      "properties": {
+        "name": {
+          "description": "The switch's name as the backend sends it, e.g. partner.notifications_enabled. Never a store value source.",
+          "type": "string",
+          "minLength": 1
+        },
+        "enabled": {
+          "description": "On, off, or null when the entry carried no state the CLI can read.",
+          "oneOf": [{ "type": "null" }, { "type": "boolean" }]
+        },
+        "kind": {
+          "description": "route_gate: off, its routes answer 404. posture: changes how routes behave, and off is often its normal state. unknown: the entry neither says which nor names what it gates. The backend's kind when it sends one; otherwise a switch that names what it gates is a route_gate. Members may be added.",
+          "enum": ["route_gate", "posture", "unknown"]
+        },
+        "gates": {
+          "description": "What the switch governs, as the backend names it: routes, capabilities or a description.",
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "tenantTerm": {
+          "description": "The tenant-level feature term the switch pairs with, or null.",
+          "oneOf": [{ "type": "null" }, { "type": "string", "minLength": 1 }]
+        },
+        "reason": {
+          "description": "The server's own copy for the switch, or an empty string.",
+          "type": "string"
+        },
+        "nextAction": {
+          "description": "CLI-authored. Only a route_gate is told to ask Everfur to switch it on.",
+          "type": "string",
+          "minLength": 1
+        }
+      }
     }
   }
 }

package/schema/plan.v1.schema.json

@@ -48,6 +48,14 @@
         "sessionMintLanguage": {
           "description": "The backend language that mints sessions. Non-null only when the identity mode requires a server-side mint.",
           "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/OptionId" }]
+        },
+        "embedding": {
+          "description": "--embedding, when given: how a web project embeds the surface (an option of the platform tree's web-embedding question). null means the detected embedding decided. Additive to v1; absent on documents written before the web shapes existed.",
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/OptionId" }]
+        },
+        "environment": {
+          "description": "--environment, when given: the Everfur deployment the generated configuration targets. null means it was not given; a plan that writes configuration refuses without it. Additive to v1.",
+          "oneOf": [{ "type": "null" }, { "enum": ["test", "staging", "production"] }]
         }
       }
     },
@@ -73,6 +81,10 @@
       "type": "array",
       "items": { "$ref": "#/$defs/PlanWarning" }
     },
+    "platformBlock": {
+      "description": "Non-null when the host project shape refuses every plan, whatever was asked for. Absent on documents written before the field existed.",
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/PlatformBlock" }]
+    },
     "decisionSpace": {
       "description": "Which contract projection produced this plan. Null only on the refusal that says none was found.",
       "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/DecisionSpaceProvenance" }]
@@ -128,7 +140,7 @@
       "$ref": "#/$defs/OptionId"
     },
     "ProjectType": {
-      "enum": ["expo-managed", "bare-react-native", "flutter", "web", "unknown"]
+      "enum": ["expo-managed", "bare-react-native", "flutter", "web", "shopify-storefront", "unknown"]
     },
     "PackageManager": {
       "enum": ["npm", "pnpm", "yarn", "bun", "not-applicable", "undetermined"]
@@ -149,7 +161,66 @@
         "projectTypeEvidence": { "type": "array", "items": { "type": "string" } },
         "packageManager": { "$ref": "#/$defs/PackageManager" },
         "packageManagerEvidence": { "type": "array", "items": { "type": "string" } },
-        "dependencies": { "type": "array", "items": { "$ref": "#/$defs/Dependency" } }
+        "dependencies": { "type": "array", "items": { "$ref": "#/$defs/Dependency" } },
+        "webEmbedding": {
+          "description": "The detected embedding of a web project: in-page when package.json declares react-dom, frame otherwise. null for every other shape. Additive to v1.",
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/OptionId" }]
+        },
+        "webFramework": {
+          "description": "The detected framework of a web project, which spells the generated files. null for every other shape. Additive to v1.",
+          "oneOf": [{ "type": "null" }, { "enum": ["next-app-router", "next-pages-router", "vite-react", "remix", "static-html", "other-web"] }]
+        },
+        "theme": {
+          "description": "What the project says about its own look, read statically by the theme detector: the source, the confidence, the SDK theme fields it mapped, the file:line evidence for each, the files it read, and the facts it could not establish. null for a shape the plan writes no provider for, or a detection built by hand. Additive to v1.",
+          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/ThemeDetection" }]
+        }
+      }
+    },
+    "ThemeToken": {
+      "enum": ["primaryColor", "accentColor", "primaryColorDark", "accentColorDark", "brightness", "surfaceStyle", "radiusScale", "fontFamily", "fontRegular", "fontMedium", "fontBold"]
+    },
+    "ThemeDetection": {
+      "type": "object",
+      "required": ["source", "confidence", "theme", "evidence", "scanned", "missing", "inferred"],
+      "properties": {
+        "source": { "enum": ["tailwind-v4", "tailwind-v3", "css-variables", "react-navigation", "rn-colors", "none"] },
+        "confidence": { "enum": ["high", "medium", "low"] },
+        "theme": {
+          "description": "The EverfurThemeInput fields the detector mapped, every value a string. Empty at low confidence.",
+          "type": "object",
+          "properties": {
+            "primaryColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "accentColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "primaryColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "accentColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "brightness": { "enum": ["light", "dark"] },
+            "surfaceStyle": { "enum": ["white", "cream", "subtle"] },
+            "radiusScale": { "enum": ["sharp", "default", "round"] },
+            "fontFamily": { "type": "string", "minLength": 1 },
+            "fontRegular": { "type": "string", "minLength": 1, "description": "The registered regular face a React Native theme file names (the SDK's fonts.regular). Additive to v1." },
+            "fontMedium": { "type": "string", "minLength": 1, "description": "The registered medium face (fonts.medium). Additive to v1." },
+            "fontBold": { "type": "string", "minLength": 1, "description": "The registered bold face (fonts.bold). Additive to v1." }
+          },
+          "additionalProperties": false
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["file", "line", "key", "value", "token", "reason"],
+            "properties": {
+              "file": { "type": "string", "minLength": 1 },
+              "line": { "type": "integer", "minimum": 1 },
+              "key": { "type": "string", "minLength": 1 },
+              "value": { "type": "string" },
+              "token": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/ThemeToken" }] },
+              "reason": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "scanned": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "missing": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "inferred": { "type": "array", "items": { "$ref": "#/$defs/ThemeToken" } }
       }
     },
     "Dependency": {
@@ -176,12 +247,25 @@
           "pattern": "^/"
         },
         "capabilityKeys": {
-          "description": "The capability pack keys this block derives from.",
+          "description": "The capability pack keys this block derives from. Empty when the platform, not the capability, is what refused.",
           "type": "array",
           "items": { "type": "string", "minLength": 1 }
+        },
+        "blockedBy": {
+          "description": "What refused it: a BLOCKED terminal in the capabilities tree, or the host project shape. Absent means capability, for documents written before the field existed.",
+          "enum": ["capability", "platform"]
         }
       }
     },
+    "PlatformBlock": {
+      "type": "object",
+      "required": ["reason", "unblockOwner", "requestPath"],
+      "properties": {
+        "reason": { "type": "string", "minLength": 1 },
+        "unblockOwner": { "type": "string", "minLength": 1 },
+        "requestPath": { "type": "string", "pattern": "^/" }
+      }
+    },
     "PlanPrinciple": {
       "type": "object",
       "required": ["treeId", "id", "title", "statement", "docPath"],
@@ -211,9 +295,11 @@
             "decisionTrees",
             "projectType",
             "packageManager",
+            "embedding",
             "capabilities",
             "identityMode",
-            "sessionMintLanguage"
+            "sessionMintLanguage",
+            "environment"
           ]
         },
         "reason": { "type": "string", "minLength": 1 },

package/schema/verification.v1.schema.json

@@ -17,7 +17,7 @@
       }
     },
     "status": {
-      "description": "passed = every step PASSed. failed = at least one FAILed (exit 7). incomplete = nothing failed but a step was skipped (exit 3).",
+      "description": "passed = every step PASSed or was GATED. failed = at least one FAILed (exit 7). incomplete = nothing failed but a step was skipped (exit 3).",
       "enum": ["passed", "failed", "incomplete"]
     },
     "baseUrl": { "type": "string", "minLength": 1 },
@@ -27,7 +27,8 @@
       "properties": {
         "passed": { "type": "integer", "minimum": 0 },
         "failed": { "type": "integer", "minimum": 0 },
-        "skipped": { "type": "integer", "minimum": 0 }
+        "skipped": { "type": "integer", "minimum": 0 },
+        "gated": { "description": "Additive to v1: steps that found a surface switched off by Everfur.", "type": "integer", "minimum": 0 }
       }
     },
     "steps": {
@@ -39,7 +40,10 @@
         "properties": {
           "id": { "type": "string", "minLength": 1 },
           "title": { "type": "string", "minLength": 1 },
-          "result": { "enum": ["PASS", "FAIL", "SKIP"] },
+          "result": {
+            "description": "GATED (additive to v1): the step ran and found a surface Everfur has switched off for the tenant. It is not a failure and not a skip, so it changes the status in neither direction.",
+            "enum": ["PASS", "FAIL", "SKIP", "GATED"]
+          },
           "reason": {
             "description": "Always populated, for every result. A bare PASS is not a report.",
             "type": "string",