@vitronai/themis 0.1.0-beta.0 → 0.1.0-beta.2

package/docs/api.md

@@ -9,6 +9,8 @@ This document defines the public API surface for Themis `0.1.0-beta.0`.
 ```bash
 themis test [options]
 themis init
+themis generate [path]
+themis migrate <jest|vitest>
 ```
 
 ## `themis init`
@@ -18,6 +20,137 @@ Creates:
 - `themis.config.json` with default settings
 - `tests/example.test.js` sample test (if missing)
 
+## `themis generate`
+
+Scans a source directory and writes generated Themis unit-layer tests.
+
+Default behavior:
+
+- input directory: `src`
+- output directory: `tests/generated`
+- generated files mirror the scanned source tree with `*.generated.test.js`
+- generated tests assert normalized runtime export contracts directly in generated source
+- scenario adapters cover React components, React hooks, Next app components, Next route handlers, generic route handlers, and Node service functions when inputs can be inferred or hinted
+- React component and hook adapters also assert inferred interaction/state contracts when event handlers or zero-argument stateful methods are available
+- React and Next component adapters also emit direct DOM-state contract assertions that capture visible text, inferred roles, non-event attributes, and interaction-driven UI changes
+- React and Next component adapters can also emit async behavioral flow contracts when `componentFlows` are inferred or supplied, including richer inferred input/submit/loading/success flows for common async forms
+- project-level providers from `themis.generate.js` / `themis.generate.cjs` can match source files, inject shared fixture data, register runtime mocks, and wrap generated component renders for provider-aware DOM contracts and behavioral flow coverage
+- provider presets can declare router, Next navigation, auth/session, React Query, Zustand, and Redux-style wrapper metadata without hand-writing every wrapper shell
+- richer flow expectations can assert text transitions, attribute state, and role presence for empty, disabled, retry, error, and recovery paths
+- `.themis/generate-map.json` records source-to-generated-test mappings plus scenario metadata
+- `.themis/generate-last.json` stores the full machine-readable generate payload
+- `.themis/generate-handoff.json` stores a compact prompt-ready handoff payload for agents
+- `.themis/generate-backlog.json` stores unresolved skips, conflicts, and confidence debt with suggested remediation
+
+## `themis generate` options
+
+| Option | Type | Description |
+| --- | --- | --- |
+| `--json` | flag | Print a machine-readable generation payload (`themis.generate.result.v1`). |
+| `--plan` | flag | Alias for `--review --json`, plus persisted handoff artifacts for agent loops. |
+| `--review` | flag | Preview create/update/remove decisions without writing files. |
+| `--update` | flag | Refresh existing generated files only. |
+| `--clean` | flag | Remove generated files for the selected scope. |
+| `--changed` | flag | Limit selection to changed files in the current git worktree. |
+| `--write-hints` | flag | Scaffold missing `.themis.json` hint sidecars and use them in the same generate run. |
+| `--strict` | flag | Fail generation on skips, conflicts, or entries below `high` confidence. |
+| `--fail-on-skips` | flag | Fail generation when any selected source file is skipped. |
+| `--fail-on-conflicts` | flag | Fail generation when conflicts remain unresolved. |
+| `--files <paths>` | string | Comma-separated list of explicit source files to generate for. |
+| `--scenario <name>` | string | Limit generation to one adapter family. |
+| `--min-confidence <level>` | string | Keep only entries at or above `low`, `medium`, or `high`. |
+| `--require-confidence <level>` | string | Fail generation if selected entries fall below `low`, `medium`, or `high`. |
+| `--match-source <regex>` | string | Filter candidate source files by relative path regex. |
+| `--match-export <regex>` | string | Filter candidate source files by exported symbol regex. |
+| `--include <regex>` | string | Include only source files whose relative path matches regex. |
+| `--exclude <regex>` | string | Exclude source files whose relative path matches regex. |
+| `--output <path>` | string | Output directory for generated tests (default: `tests/generated`). |
+| `--force` | flag | Replace conflicting files that were not created by a prior Themis scan. |
+
+Per-file hint sidecars are supported via `<source>.themis.json`. These can provide:
+
+- `componentProps`
+- `componentInteractions`
+- `componentFlows`
+- `hookArgs`
+- `hookInteractions`
+- `serviceArgs`
+- `routeRequests`
+- `routeContext`
+- `includeExports`
+- `excludeExports`
+- `scenarios`
+
+`componentProps` and `routeRequests`/`routeContext` also steer Next app component and Next route handler adapters.
+
+Project-level provider modules are supported via `themis.generate.js` or `themis.generate.cjs` at the repo root. A provider can expose:
+
+- `include` / `exclude` / `files`: source matching rules
+- any of the same static fixture keys as sidecars (`componentProps`, `componentInteractions`, `componentFlows`, `hookArgs`, `hookInteractions`, `serviceArgs`, `routeRequests`, `routeContext`, `scenarios`)
+- `router`: preset router wrapper metadata (`path`, `params`, `search`)
+- `router`: also supports `name`, `history`, and `state`
+- `nextNavigation`: preset Next navigation wrapper metadata (`pathname`, `params`, `searchParams`)
+- `nextNavigation`: also supports `segment` and `locale`
+- `auth`: preset auth/session wrapper metadata (`user`, `session`, `state`)
+- `auth`: also supports `roles` and `permissions`
+- `reactQuery`: preset React Query wrapper metadata (`clientName`, `state`, `cache`)
+- `reactQuery`: also supports `status`, `fetchStatus`, and `queries`
+- `zustand`: preset Zustand wrapper metadata (`name`, `state`)
+- `zustand`: also supports `selectors` and `actions`
+- `redux`: preset Redux wrapper metadata (`slice`, `state`)
+- `redux`: also supports `selectors` and `actions`
+- `applyMocks(context)`: runtime mock registration for generated tests
+- `wrapRender(context)`: provider-aware render wrapping for generated React and Next component adapters
+
+`applyMocks(context)` receives:
+
+- `sourceFile`
+- `sourcePath`
+- `exportName`
+- `scenario`
+- `mock`
+- `fn`
+- `mockFetch`
+- `resetFetchMocks`
+- `restoreFetch`
+- `useFakeTimers`
+- `useRealTimers`
+- `advanceTimersByTime`
+- `runAllTimers`
+- `flushMicrotasks`
+
+`wrapRender(context)` receives:
+
+- `sourceFile`
+- `sourcePath`
+- `exportName`
+- `scenario`
+- `element`
+- `withProviderShell(type, element, attrs)`
+- `withReactRouter(element, config?)`
+- `withNextNavigation(element, config?)`
+- `withAuthSession(element, config?)`
+- `withReactQuery(element, config?)`
+- `withZustandStore(element, config?)`
+- `withReduxStore(element, config?)`
+
+## `themis migrate`
+
+Scaffolds an incremental migration bridge for existing Jest or Vitest suites.
+
+Behavior:
+
+- writes or updates `themis.config.json`
+- adds `tests/setup.themis.js` to `setupFiles`
+- writes `themis.compat.js` as a local compatibility bridge
+- adds `test:themis` to `package.json` when missing
+- writes `.themis/migration-report.json` with detected compatibility imports and next actions
+- relies on built-in runtime compatibility for `@jest/globals`, `vitest`, and `@testing-library/react`
+
+Migration options:
+
+- `--rewrite-imports`: rewrites matched imports from `@jest/globals`, `vitest`, and `@testing-library/react` to the local `themis.compat.js` bridge
+
 ## `themis test` options
 
 | Option | Type | Description |
@@ -28,20 +161,44 @@ Creates:
 | `--reporter spec\|next\|json\|agent\|html` | string | Explicit reporter override. |
 | `--workers <N>` | positive integer | Override worker count. Invalid values fail fast. |
 | `--environment node\|jsdom` | string | Override the configured test environment. |
+| `--isolation worker\|in-process` | string | Select worker isolation or a zero-IPC in-process execution mode. |
+| `--cache` | flag | Enable file-level result caching for in-process local loops. |
 | `-w`, `--watch` | flag | Rerun the selected suite when watched project files change. |
-| `-u`, `--update-snapshots` | flag | Update snapshot files when `toMatchSnapshot()` values change. |
 | `--stability <N>` | positive integer | Run selected tests `N` times and classify stability (`stable_pass`, `stable_fail`, `unstable`). |
 | `--html-output <path>` | string | Output path for `--reporter html` (default: `.themis/report.html`). |
 | `--match "<regex>"` | string | Run only tests whose full name matches regex. |
 | `--rerun-failed` | flag | Rerun failures from `.themis/failed-tests.json`. |
 | `--no-memes` | flag | Disable meme intent aliases (`cook`, `yeet`, `vibecheck`, `wipe`). |
+
+Migration compatibility:
+
+- imports from `@jest/globals` are supported at runtime
+- imports from `vitest` are supported at runtime
+- imports from `@testing-library/react` are supported via Themis `render`, `screen`, `fireEvent`, `waitFor`, `cleanup`, and `act`
+- `themis migrate <jest|vitest>` also emits `.themis/migration-report.json` with detected files and recommended next actions
+
+Additional option:
+
 | `--lexicon classic\|themis` | string | Human reporter terminology mode for `next/spec`. |
 
+Execution note:
+
+- `--watch --isolation in-process --cache` is the fastest local rerun mode
+- `--isolation worker` remains the safer mode for CI and global-heavy suites
+
+Snapshot note:
+
+- Themis no longer supports first-party snapshot files or `-u` update flows. Prefer direct assertions and generated contract tests.
+
 ## Exit behavior
 
 - Exit code `0`: all selected tests passed or were skipped.
 - Exit code `1`: any selected test failed, invalid usage, or runtime error.
 
+Generate-specific note:
+
+- `themis generate` exits `1` when active generate gates fail, including unresolved conflicts in write mode.
+
 `--lexicon` does not affect machine payload contracts (`--json`, `--agent`, or artifacts).
 
 ## Artifacts
@@ -52,10 +209,17 @@ Each run writes to `.themis/`:
 - `failed-tests.json`: failed subset (`themis.failures.v1`)
 - `run-diff.json`: diff against the previous run
 - `run-history.json`: rolling recent-run history
+- `fix-handoff.json`: deduped repair artifact for generated test failures (`themis.fix.handoff.v1`)
+- `migration-report.json`: migration inventory for Jest/Vitest bridge scaffolds (`themis.migration.report.v1`)
 
 Formal schemas:
 
 - `docs/schemas/agent-result.v1.json`
+- `docs/schemas/generate-result.v1.json`
+- `docs/schemas/generate-map.v1.json`
+- `docs/schemas/generate-handoff.v1.json`
+- `docs/schemas/generate-backlog.v1.json`
+- `docs/schemas/fix-handoff.v1.json`
 - `docs/schemas/failures.v1.json`
 
 Human-facing artifact:
@@ -68,6 +232,52 @@ Agent payload details:
 - `analysis.failureClusters` groups failures by shared fingerprint
 - `analysis.stability` captures multi-run classifications and per-test status sequences
 - `analysis.comparison` reports delta stats plus new and resolved failures against the previous run
+- `artifacts.fixHandoff` points to `.themis/fix-handoff.json` for generated failure repair loops
+- fix handoff entries include `repairStrategy`, `candidateFiles`, and `autofixCommand` for machine repair loops
+
+## UI Test Utilities
+
+Themis exposes a lightweight DOM-oriented helper layer for `jsdom` tests:
+
+- `render(input, options?)`
+- `screen.getByText(text)`
+- `screen.queryByText(text)`
+- `screen.getByRole(role, options?)`
+- `screen.queryByRole(role, options?)`
+- `screen.getByLabelText(labelText)`
+- `fireEvent.click(node)`
+- `fireEvent.change(node, payload?)`
+- `fireEvent.input(node, payload?)`
+- `fireEvent.submit(node)`
+- `fireEvent.keyDown(node, payload?)`
+- `waitFor(assertion, options?)`
+- `cleanup()`
+- `useFakeTimers()`
+- `useRealTimers()`
+- `advanceTimersByTime(ms)`
+- `runAllTimers()`
+- `flushMicrotasks()`
+- `mockFetch(handlerOrResponse)`
+- `resetFetchMocks()`
+- `restoreFetch()`
+
+Supported DOM matchers:
+
+- `expect(node).toHaveTextContent(text)`
+- `expect(node).toHaveAttribute(name, value?)`
+- `expect(node).toBeInTheDocument()`
+
+These helpers are intentionally small and deterministic. They are designed for generated UI unit-layer tests and human-authored component tests running in Themis `jsdom` mode.
+
+`mockFetch(...)` accepts either:
+
+- a function `(input, init) => response`
+- a Response instance
+- a shorthand object like `{ status, headers, body }` or `{ status, json }`
+
+When the handler form is used, shorthand objects returned by the handler are normalized into `Response` instances before the generated test consumes them.
+
+The fake timer helpers only patch the current Themis runtime. They do not mutate system time outside the active test process.
 
 ## Config File (`themis.config.json`)
 
@@ -80,6 +290,7 @@ Agent payload details:
 | `environment` | `node\|jsdom` | `"node"` | Test runtime environment. |
 | `setupFiles` | `string[]` | `[]` | Files loaded before each test file. |
 | `tsconfigPath` | `string \| null` | `"tsconfig.json"` | Project tsconfig used for TSX and alias-aware transpilation. |
+| `testIgnore` | `string[]` | `[]` | Regex strings matched against repo-relative paths during discovery. Matching files and directories are skipped. |
 
 ## Programmatic API
 
@@ -106,7 +317,6 @@ Options:
 - `environment?: "node" | "jsdom"`
 - `setupFiles?: string[]`
 - `tsconfigPath?: string | null`
-- `updateSnapshots?: boolean`
 
 ## `runTests(files, options?): Promise<RunResult>`
 
@@ -122,20 +332,79 @@ Options:
 - `environment?: "node" | "jsdom"`
 - `setupFiles?: string[]`
 - `tsconfigPath?: string | null`
-- `updateSnapshots?: boolean`
 
 ## `discoverTests(cwd, config): string[]`
 
 Discovers test files from config.
 
+## `generateTestsFromSource(cwd, options?): GenerateSummary`
+
+Scans exported source modules and writes deterministic generated tests plus mapping artifacts.
+
+Options:
+
+- `targetDir?: string`
+- `outputDir?: string`
+- `force?: boolean`
+- `writeHints?: boolean`
+- `plan?: boolean`
+- `review?: boolean`
+- `update?: boolean`
+- `clean?: boolean`
+- `changed?: boolean`
+- `strict?: boolean`
+- `failOnSkips?: boolean`
+- `failOnConflicts?: boolean`
+- `requireConfidence?: string | null`
+- `files?: string[] | string`
+- `scenario?: string | null`
+- `minConfidence?: string | null`
+- `matchSource?: string | null`
+- `matchExport?: string | null`
+- `include?: string | null`
+- `exclude?: string | null`
+
+Generated tests can consume repo-level providers from `themis.generate.js` / `themis.generate.cjs` automatically. No extra flag is required.
+
+Returns absolute paths for scanned files, selected generated files, removed stale generated files, skipped files, detailed per-entry actions, prompt text, and artifact locations.
+
+Generate payload note:
+
+- `mode.writeHints` indicates whether scaffold hint generation was enabled
+- `hintFiles` reports created, updated, and unchanged scaffold sidecars for the run
+
+## `buildGeneratePayload(summary, cwd?): GeneratePayload`
+
+Converts a `GenerateSummary` into the same machine-readable payload emitted by `themis generate --json`.
+
+## `buildGenerateBacklogPayload(summary, cwd?): GenerateBacklogPayload`
+
+Builds the unresolved-work artifact persisted at `.themis/generate-backlog.json`.
+
+## `buildGenerateHandoff(payload): GenerateHandoffPayload`
+
+Builds the compact handoff payload persisted at `.themis/generate-handoff.json`.
+
+## `writeGenerateArtifacts(summary, cwd?): { payload, handoff, backlog }`
+
+Writes `.themis/generate-last.json`, `.themis/generate-handoff.json`, and `.themis/generate-backlog.json` for a generate run and returns all three payloads.
+
 ## `loadConfig(cwd): ThemisConfig`
 
 Loads `themis.config.json` and merges with defaults.
 
+Discovery note:
+
+- `testIgnore` is applied to repo-relative file and directory paths before descent, so patterns like `^tests/generated(?:/|$)` keep generated output out of default test runs without changing `testDir`.
+
 ## `initConfig(cwd): void`
 
 Creates `themis.config.json` if missing.
 
+## `runMigrate(cwd, framework): MigrationResult`
+
+Scaffolds an incremental migration bridge for `jest` or `vitest`.
+
 ## `DEFAULT_CONFIG: ThemisConfig`
 
 Default configuration object used by `loadConfig` and `initConfig`.
@@ -158,7 +427,6 @@ Built-in matcher API:
 - `toHaveBeenCalled()`
 - `toHaveBeenCalledTimes(expected)`
 - `toHaveBeenCalledWith(...args)`
-- `toMatchSnapshot(name?)`
 
 Machine-facing note:
 

package/docs/schemas/agent-result.v1.json

@@ -25,7 +25,7 @@
     "artifacts": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["lastRun", "failedTests", "runDiff", "runHistory"],
+      "required": ["lastRun", "failedTests", "runDiff", "runHistory", "fixHandoff"],
       "properties": {
         "lastRun": {
           "type": "string"
@@ -38,6 +38,9 @@
         },
         "runHistory": {
           "type": "string"
+        },
+        "fixHandoff": {
+          "type": "string"
         }
       }
     },
@@ -47,7 +50,7 @@
     "hints": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["rerunFailed", "targetedRerun", "updateSnapshots", "diffLastRun"],
+      "required": ["rerunFailed", "targetedRerun", "diffLastRun", "repairGenerated"],
       "properties": {
         "rerunFailed": {
           "type": "string"
@@ -55,10 +58,10 @@
         "targetedRerun": {
           "type": "string"
         },
-        "updateSnapshots": {
+        "diffLastRun": {
           "type": "string"
         },
-        "diffLastRun": {
+        "repairGenerated": {
           "type": "string"
         }
       }

package/docs/schemas/fix-handoff.v1.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/vitron-ai/themis/docs/schemas/fix-handoff.v1.json",
+  "title": "Themis Fix Handoff v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "runId", "createdAt", "summary", "artifacts", "items", "nextActions"],
+  "properties": {
+    "schema": {
+      "type": "string",
+      "const": "themis.fix.handoff.v1"
+    },
+    "runId": {
+      "type": "string"
+    },
+    "createdAt": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["totalFailures", "generatedFailures", "staleSources", "contractFailures"],
+      "properties": {
+        "totalFailures": { "type": "number" },
+        "generatedFailures": { "type": "number" },
+        "staleSources": { "type": "number" },
+        "contractFailures": { "type": "number" }
+      }
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["failedTests", "generateMap", "generateBacklog", "fixHandoff"],
+      "properties": {
+        "failedTests": { "type": "string" },
+        "generateMap": { "type": "string" },
+        "generateBacklog": { "type": "string" },
+        "fixHandoff": { "type": "string" }
+      }
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "file",
+          "name",
+          "fullName",
+          "message",
+          "testFile",
+          "sourceFile",
+          "moduleKind",
+          "confidence",
+          "scenarios",
+          "hintsFile",
+          "category",
+          "failureCount",
+          "failedTests",
+          "repairStrategy",
+          "candidateFiles",
+          "suggestedAction",
+          "suggestedCommand",
+          "autofixCommand"
+        ],
+        "properties": {
+          "file": { "type": "string" },
+          "name": { "type": "string" },
+          "fullName": { "type": "string" },
+          "message": { "type": "string" },
+          "testFile": { "type": "string" },
+          "sourceFile": { "type": "string" },
+          "moduleKind": { "type": ["string", "null"] },
+          "confidence": { "type": ["string", "null"] },
+          "scenarios": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "hintsFile": { "type": ["string", "null"] },
+          "category": {
+            "type": "string",
+            "enum": ["source-drift", "generated-contract-failure"]
+          },
+          "failureCount": { "type": "number" },
+          "failedTests": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "repairStrategy": { "type": "string" },
+          "candidateFiles": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "suggestedAction": { "type": "string" },
+          "suggestedCommand": { "type": ["string", "null"] },
+          "autofixCommand": { "type": ["string", "null"] }
+        }
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/docs/schemas/generate-backlog.v1.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/vitron-ai/themis/docs/schemas/generate-backlog.v1.json",
+  "title": "Themis Generate Backlog v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "source", "filters", "gates", "summary", "items"],
+  "properties": {
+    "schema": {
+      "type": "string",
+      "const": "themis.generate.backlog.v1"
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["targetDir", "outputDir"],
+      "properties": {
+        "targetDir": { "type": "string" },
+        "outputDir": { "type": "string" }
+      }
+    },
+    "filters": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["plan", "changed", "files", "scenario", "minConfidence", "matchSource", "matchExport", "include", "exclude"],
+      "properties": {
+        "plan": { "type": "boolean" },
+        "changed": { "type": "boolean" },
+        "files": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "scenario": { "type": ["string", "null"] },
+        "minConfidence": { "type": ["string", "null"] },
+        "matchSource": { "type": ["string", "null"] },
+        "matchExport": { "type": ["string", "null"] },
+        "include": { "type": ["string", "null"] },
+        "exclude": { "type": ["string", "null"] }
+      }
+    },
+    "gates": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["strict", "failOnSkips", "failOnConflicts", "requireConfidence", "failed", "failures"],
+      "properties": {
+        "strict": { "type": "boolean" },
+        "failOnSkips": { "type": "boolean" },
+        "failOnConflicts": { "type": "boolean" },
+        "requireConfidence": { "type": ["string", "null"] },
+        "failed": { "type": "boolean" },
+        "failures": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/gateFailure" }
+        }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["total", "errors", "warnings", "skipped", "conflicts", "confidence"],
+      "properties": {
+        "total": { "type": "number" },
+        "errors": { "type": "number" },
+        "warnings": { "type": "number" },
+        "skipped": { "type": "number" },
+        "conflicts": { "type": "number" },
+        "confidence": { "type": "number" }
+      }
+    },
+    "items": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/backlogItem" }
+    }
+  },
+  "$defs": {
+    "gateFailure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "count", "message"],
+      "properties": {
+        "code": { "type": "string" },
+        "count": { "type": "number" },
+        "message": { "type": "string" }
+      }
+    },
+    "backlogItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "severity",
+        "sourceFile",
+        "testFile",
+        "moduleKind",
+        "confidence",
+        "stage",
+        "hintsFile",
+        "reason",
+        "suggestedAction",
+        "suggestedCommand"
+      ],
+      "properties": {
+        "type": { "type": "string" },
+        "severity": { "type": "string", "enum": ["warning", "error"] },
+        "sourceFile": { "type": "string" },
+        "testFile": { "type": ["string", "null"] },
+        "moduleKind": { "type": ["string", "null"] },
+        "confidence": { "type": ["string", "null"] },
+        "stage": { "type": ["string", "null"] },
+        "hintsFile": { "type": ["string", "null"] },
+        "reason": { "type": "string" },
+        "suggestedAction": { "type": "string" },
+        "suggestedCommand": { "type": ["string", "null"] }
+      }
+    }
+  }
+}