@everfur/cli 0.2.1 → 0.5.0

package/dist/index.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-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';
+export { COMMANDS, buildSandboxDocument, buildVerificationDocument, failureOutcome, formatOutcome, matchCommand, nextActionsFor, parseCapabilities, parseIdentityMode, parseSessionMintLanguage, parseSuppliedFacts, projectSandboxCreate, renderDiagnosis, renderPlan, renderSandboxCreate, renderVerification, runCli } from './chunk-NLB5XDNO.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-CGWSEOW2.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everfur/cli",
-  "version": "0.2.1",
+  "version": "0.5.0",
   "description": "Everfur CLI: plan, verify, and diagnose an Everfur pet-health integration from the terminal.",
   "license": "MIT",
   "type": "module",
@@ -14,6 +14,7 @@
   "files": [
     "dist",
     "!dist/**/*.map",
+    "!dist/everfur-mcp-container.*",
     "schema"
   ],
   "publishConfig": {
@@ -70,9 +71,9 @@
     "type": "git",
     "url": "git+https://github.com/Everfur-Health/everfur-cli.git"
   },
-  "homepage": "https://github.com/Everfur-Health/everfur-cli#readme",
+  "homepage": "https://everfur.com/partners",
   "bugs": {
-    "url": "https://github.com/Everfur-Health/everfur-cli/issues"
+    "email": "support@everfur.com"
   },
   "keywords": [
     "everfur",

package/schema/error-explanation.v1.schema.json

@@ -46,12 +46,34 @@
       }
     },
     "envelope": { "type": "string", "minLength": 1 },
-    "httpStatus": { "type": "integer", "minimum": 0 },
+    "httpStatus": {
+      "description": "The HTTP status the code arrives on. null for a code with no HTTP status of its own: an SDK member, an MCP tool code, a CLI error code, a diagnostics reason code or an SDK sub-enum member.",
+      "type": ["integer", "null"],
+      "minimum": 0
+    },
     "namingFamily": { "type": "string", "minLength": 1 },
-    "retryable": { "type": "boolean" },
+    "retryable": {
+      "description": "Whether the same request can succeed if repeated. null when the source that answered does not say.",
+      "type": ["boolean", "null"]
+    },
     "confirmedOnWire": {
-      "description": "False means the code exists in source but no live route was traced emitting it. Documentation, not a contract to branch on.",
-      "type": "boolean"
+      "description": "False means the code exists in source but no live route was traced emitting it, or that it is never a wire code. Documentation, not a contract to branch on. null when the source that answered does not record it (the SDK's contract table).",
+      "type": ["boolean", "null"]
+    },
+    "alsoIn": {
+      "description": "Additive to v1: the same spelling in another vocabulary (an SDK sub-enum, a diagnostics reason code, a CLI error code), each with its own meaning, so a reader holding the other one is not handed these facts silently.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["namingFamily", "declaredIn", "cause", "retryable", "nextAction"],
+        "properties": {
+          "namingFamily": { "type": "string", "minLength": 1 },
+          "declaredIn": { "type": "string", "minLength": 1 },
+          "cause": { "type": "string", "minLength": 1 },
+          "retryable": { "type": ["boolean", "null"] },
+          "nextAction": { "type": "string", "minLength": 1 }
+        }
+      }
     },
     "surfaces": { "type": "array", "items": { "type": "string" } },
     "cause": { "type": "string" },

package/schema/plan.v1.schema.json

@@ -77,6 +77,11 @@
       "type": "array",
       "items": { "$ref": "#/$defs/PlanPrinciple" }
     },
+    "checklist": {
+      "description": "The definition of done of a ready plan: every item must hold, each proved by its verify, before the integration is reported finished. Derived from the steps, so the same plan always carries the same list. Absent on a refusal and on documents written before the field existed.",
+      "type": "array",
+      "items": { "$ref": "#/$defs/PlanChecklistItem" }
+    },
     "warnings": {
       "type": "array",
       "items": { "$ref": "#/$defs/PlanWarning" }
@@ -177,26 +182,41 @@
       }
     },
     "ThemeToken": {
-      "enum": ["primaryColor", "accentColor", "primaryColorDark", "accentColorDark", "brightness", "surfaceStyle", "radiusScale", "fontFamily", "fontRegular", "fontMedium", "fontBold"]
+      "enum": ["primaryColor", "accentColor", "primaryColorDark", "accentColorDark", "successColor", "warningColor", "infoColor", "successColorDark", "warningColorDark", "infoColorDark", "dangerColor", "dangerColorDark", "brightness", "backgroundColor", "backgroundColorDark", "textColor", "textColorDark", "surfaceStyle", "radiusScale", "borderRadius", "fontSizeBase", "fontFamily", "headingFontFamily", "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"] },
+        "source": { "enum": ["tailwind-v4", "tailwind-v3", "css-variables", "tailwind-classes", "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.",
+          "description": "The EverfurThemeInput fields the detector mapped, every value a string but the two px numbers. 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}$" },
+            "successColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "warningColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "infoColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "successColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "warningColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "infoColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "dangerColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
+            "dangerColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$" },
             "brightness": { "enum": ["light", "dark"] },
+            "backgroundColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$", "description": "The light palette's ground as the project declares it (SDK 0.9.0 background_color). Additive to v1." },
+            "backgroundColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$", "description": "The dark palette's ground. Additive to v1." },
+            "textColor": { "type": "string", "pattern": "^#[0-9A-F]{6}$", "description": "The light palette's body text (SDK 0.9.0 text_color). Additive to v1." },
+            "textColorDark": { "type": "string", "pattern": "^#[0-9A-F]{6}$", "description": "The dark palette's body text. Additive to v1." },
             "surfaceStyle": { "enum": ["white", "cream", "subtle"] },
             "radiusScale": { "enum": ["sharp", "default", "round"] },
+            "borderRadius": { "type": "number", "minimum": 0, "description": "The medium corner radius in px (SDK 0.9.0 border_radius). Additive to v1." },
+            "fontSizeBase": { "type": "number", "exclusiveMinimum": 0, "description": "The body text size in px (SDK 0.9.0 font_size_base). Additive to v1." },
             "fontFamily": { "type": "string", "minLength": 1 },
+            "headingFontFamily": { "type": "string", "minLength": 1, "description": "The headings' family (SDK 0.9.0). Additive to v1." },
             "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." }
@@ -277,6 +297,16 @@
         "docPath": { "oneOf": [{ "type": "null" }, { "type": "string", "pattern": "^/" }] }
       }
     },
+    "PlanChecklistItem": {
+      "type": "object",
+      "required": ["id", "requirement", "verify", "steps"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "requirement": { "type": "string", "minLength": 1 },
+        "verify": { "type": "string", "minLength": 1 },
+        "steps": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    },
     "DecisionSpaceProvenance": {
       "type": "object",
       "required": ["source", "digest", "trees"],
@@ -303,7 +333,22 @@
           ]
         },
         "reason": { "type": "string", "minLength": 1 },
-        "supplyWith": { "type": "string", "minLength": 1 }
+        "supplyWith": { "type": "string", "minLength": 1 },
+        "requiredWhen": {
+          "description": "Additive to v1: the fact is needed only when another fact missing from the same refusal takes one of these answers. It is asked in the same round so every answer is collected at once; given with any other answer, it is unused.",
+          "type": "object",
+          "required": ["fact", "oneOf"],
+          "properties": {
+            "fact": { "type": "string", "minLength": 1 },
+            "oneOf": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+          }
+        },
+        "options": {
+          "description": "Additive to v1: present when only some of the fact's answers resolve this refusal, such as the identity modes a capability or the project shape admits. A caller offers these and no others; the answer the refusal rejected is never among them.",
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
       }
     },
     "PlanStep": {

package/schema/verification.v1.schema.json

@@ -17,7 +17,7 @@
       }
     },
     "status": {
-      "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).",
+      "description": "passed = every step PASSed, was GATED or was N/A. 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 },
@@ -28,7 +28,8 @@
         "passed": { "type": "integer", "minimum": 0 },
         "failed": { "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 }
+        "gated": { "description": "Additive to v1: steps that found a surface switched off by Everfur.", "type": "integer", "minimum": 0 },
+        "notApplicable": { "description": "Additive to v1: checks that do not apply to this integration, such as the frame's embed fence for an in-page page. Present only when one was N/A.", "type": "integer", "minimum": 0 }
       }
     },
     "steps": {
@@ -41,8 +42,8 @@
           "id": { "type": "string", "minLength": 1 },
           "title": { "type": "string", "minLength": 1 },
           "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"]
+            "description": "GATED (additive to v1): the step ran and found a surface Everfur has switched off for the tenant. N/A (additive to v1): the check does not apply to this integration (the frame's embed fence and loader for an in-page page) and was not run. Neither is a failure or a skip, so each changes the status in neither direction.",
+            "enum": ["PASS", "FAIL", "SKIP", "GATED", "N/A"]
           },
           "reason": {
             "description": "Always populated, for every result. A bare PASS is not a report.",

package/dist/everfur-mcp-container.d.ts

@@ -1,2 +0,0 @@
-
-export {  }

package/dist/everfur-mcp-container.js

@@ -1,60 +0,0 @@
-#!/usr/bin/env node
-import { loadHostedMcpConfig, startHostedMcpServer } from './chunk-SJUEHHU6.js';
-import { startRemoteMcpServer, loadRemoteMcpConfig } from './chunk-FC23PLWG.js';
-import './chunk-XMIERMOW.js';
-import { CLI_VERSION } from './chunk-KQICUK54.js';
-
-// src/mcp/container-entry.ts
-var HOSTED_MARKER = "MCP_PUBLIC_URL";
-var SELF_HOSTED_MARKER = "EVERFUR_MCP_HTTP_ACCESS_TOKEN";
-function isSet(env, name) {
-  return (env[name] ?? "").trim().length > 0;
-}
-function selectContainerEntry(env) {
-  const hosted = isSet(env, HOSTED_MARKER);
-  const selfHosted = isSet(env, SELF_HOSTED_MARKER);
-  if (hosted && !selfHosted) return { kind: "hosted" };
-  if (selfHosted && !hosted) return { kind: "self-hosted" };
-  if (hosted && selfHosted) {
-    return {
-      kind: "refused",
-      message: `both ${HOSTED_MARKER} and ${SELF_HOSTED_MARKER} are set. The image runs one entry: the Everfur-hosted server (${HOSTED_MARKER}) or the partner self-hosted server (${SELF_HOSTED_MARKER}), never both.`
-    };
-  }
-  return {
-    kind: "refused",
-    message: `neither ${HOSTED_MARKER} nor ${SELF_HOSTED_MARKER} is set. Set ${HOSTED_MARKER} (with EVERFUR_API_BASE_URL and EVERFUR_MCP_HTTP_PORT) for the Everfur-hosted server, or ${SELF_HOSTED_MARKER} (with that deployment's Everfur credentials) for the partner self-hosted server.`
-  };
-}
-
-// src/bin/everfur-mcp-container.ts
-async function main() {
-  const choice = selectContainerEntry(process.env);
-  if (choice.kind === "refused") throw new Error(choice.message);
-  let running;
-  if (choice.kind === "hosted") {
-    const config = loadHostedMcpConfig(process.env);
-    running = await startHostedMcpServer({ config });
-    process.stderr.write(`everfur-mcp-hosted listening at ${running.url.toString()} as ${config.publicUrl}
-`);
-  } else {
-    running = await startRemoteMcpServer(loadRemoteMcpConfig(process.env));
-    process.stderr.write(`everfur-mcp-http listening at ${running.url.toString()}
-`);
-  }
-  const stop = () => {
-    running.close().then(() => process.exit(0), () => process.exit(1));
-  };
-  process.once("SIGTERM", stop);
-  process.once("SIGINT", stop);
-}
-if (process.argv.slice(2).includes("--version")) {
-  process.stdout.write(`${CLI_VERSION}
-`);
-} else {
-  main().catch((error) => {
-    process.stderr.write(`everfur-mcp-container: ${error instanceof Error ? error.message : String(error)}
-`);
-    process.exit(1);
-  });
-}