mmt-mcp 1.47.1 → 1.49.0-pre

package/dist/examples/README.md

@@ -18,7 +18,7 @@ Suites against well-known **public** APIs (no Multimeter echo server). See [`rea
 
 ## Intermediate
 
-Use these when you are ready for reusable APIs, authentication, mock servers, richer environment variables, inputs and outputs, suites, tag filters (`filter.only` / `filter.skip`), imports, data-driven tests, environment presets, documentation options/ranges, control flow, comparison operators (`expect` / `check` / `assert`), helper JavaScript, additional protocol or file formats, converting a small OpenAPI / Postman / WSDL / HTTP / Bruno file to `.mmt`, and the `omit` keyword.
+Use these when you are ready for reusable APIs, authentication, mock servers, richer environment variables (presets, OS `$VAR`, live `./….mmt` — see `intermediate/10_environment_variables`), inputs and outputs, suites, tag filters (`filter.only` / `filter.skip`), imports, data-driven tests, documentation options/ranges, control flow, comparison operators (`expect` / `check` / `assert`), helper JavaScript, additional protocol or file formats, converting a small OpenAPI / Postman / WSDL / HTTP / Bruno file to `.mmt`, and the `omit` keyword.
 
 ## Professional
 

package/dist/examples/basic/03_environment_variables/README.md

@@ -34,7 +34,7 @@ npx testlight run examples/basic/03_environment_variables/get_json.mmt \
 ## Key concepts
 
 - **`<<e:var>>`** embeds an environment variable inside a string.
+- Presets, OS `$VAR` refs, and live `./….mmt` values are covered in [Environment Variables (intermediate)](../../intermediate/10_environment_variables/).
 - POST requests with env headers are covered later in [Environment POST Echo](../../intermediate/19_environment_post_echo/).
-- Presets are covered later in [Environment Presets](../../intermediate/10_environment_presets/).
 
 See [Environment docs](../../../docs/files/env/index.md) for full details.

package/dist/examples/examples-index.json

@@ -304,22 +304,64 @@
     "title": "Data driven echo test"
   },
   {
-    "path": "intermediate/10_environment_presets/api/echo_env.mmt",
+    "path": "intermediate/10_environment_variables/live_variables/consume_session_api.mmt",
     "type": "api",
     "category": "intermediate",
-    "title": "Echo with Environment"
+    "title": "Echo both live sessions"
+  },
+  {
+    "path": "intermediate/10_environment_variables/live_variables/consume_session_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "Read live env from a test"
+  },
+  {
+    "path": "intermediate/10_environment_variables/live_variables/create_session_api.mmt",
+    "type": "api",
+    "category": "intermediate",
+    "title": "Create session (API)"
   },
   {
-    "path": "intermediate/10_environment_presets/multimeter.mmt",
+    "path": "intermediate/10_environment_variables/live_variables/create_session_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "Create session (test)"
+  },
+  {
+    "path": "intermediate/10_environment_variables/multimeter.mmt",
     "type": "env",
     "category": "intermediate"
   },
   {
-    "path": "intermediate/10_environment_presets/test/preset_test.mmt",
+    "path": "intermediate/10_environment_variables/os_variables/echo_path.mmt",
+    "type": "api",
+    "category": "intermediate",
+    "title": "Echo OS PATH"
+  },
+  {
+    "path": "intermediate/10_environment_variables/os_variables/path_test.mmt",
+    "type": "test",
+    "category": "intermediate",
+    "title": "OS PATH env ref"
+  },
+  {
+    "path": "intermediate/10_environment_variables/presets/api/echo_env.mmt",
+    "type": "api",
+    "category": "intermediate",
+    "title": "Echo with Environment"
+  },
+  {
+    "path": "intermediate/10_environment_variables/presets/test/preset_test.mmt",
     "type": "test",
     "category": "intermediate",
     "title": "Environment Preset Test"
   },
+  {
+    "path": "intermediate/10_environment_variables/suite.mmt",
+    "type": "suite",
+    "category": "intermediate",
+    "title": "Environment variables"
+  },
   {
     "path": "intermediate/11_control_flow/api/echo.mmt",
     "type": "api",
@@ -1110,41 +1152,6 @@
     "category": "intermediate",
     "title": "Reuse the token in a later suite item"
   },
-  {
-    "path": "intermediate/32_environment_live_variables/consume_session_api.mmt",
-    "type": "api",
-    "category": "intermediate",
-    "title": "Echo both live sessions"
-  },
-  {
-    "path": "intermediate/32_environment_live_variables/consume_session_test.mmt",
-    "type": "test",
-    "category": "intermediate",
-    "title": "Read live env from a test"
-  },
-  {
-    "path": "intermediate/32_environment_live_variables/create_session_api.mmt",
-    "type": "api",
-    "category": "intermediate",
-    "title": "Create session (API)"
-  },
-  {
-    "path": "intermediate/32_environment_live_variables/create_session_test.mmt",
-    "type": "test",
-    "category": "intermediate",
-    "title": "Create session (test)"
-  },
-  {
-    "path": "intermediate/32_environment_live_variables/multimeter.mmt",
-    "type": "env",
-    "category": "intermediate"
-  },
-  {
-    "path": "intermediate/32_environment_live_variables/suite.mmt",
-    "type": "suite",
-    "category": "intermediate",
-    "title": "Live env consumers"
-  },
   {
     "path": "professional/01_report_generation/api/echo.mmt",
     "type": "api",

package/dist/examples/intermediate/06_imports/README.md

@@ -89,4 +89,4 @@ npx testlight run examples/intermediate/06_imports/tests/test_api.mmt --env-file
 
 - See [Simple Test](../../basic/02_simple_test/) for a direct basic test example.
 - See [CSV Data Driven Test](../09_csv_data_driven_test/) for CSV data imports.
-- See [Environment Presets](../10_environment_presets/) for environment presets in `multimeter.mmt`.
+- See [Environment Variables](../10_environment_variables/) for presets, OS `$VAR`, and live values in `multimeter.mmt`.

package/dist/examples/intermediate/10_environment_variables/README.md

@@ -0,0 +1,81 @@
+# Environment Variables
+
+Presets, OS process-env refs (`$VAR`), and live file-backed values (`./….mmt`) in one project — each concept in its own folder.
+
+## Structure
+
+```
+10_environment_variables/
+├── multimeter.mmt                 # Shared variables + presets
+├── presets/
+│   ├── api/echo_env.mmt           # <<e:api_url>>, e:mode
+│   └── test/preset_test.mmt
+├── os_variables/
+│   ├── echo_path.mmt              # Posts e:path_from_os ($PATH) in the body
+│   └── path_test.mmt
+├── live_variables/
+│   ├── create_session_api.mmt     # Live target (API → outputs.session)
+│   ├── create_session_test.mmt    # Live target (test → outputs.session, cache: 2s)
+│   ├── consume_session_test.mmt   # Asserts e:session_* look like UUIDs
+│   └── consume_session_api.mmt    # Optional Send — body uses e:session_*
+├── suite.mmt                      # preset + OS PATH + live consumers
+└── README.md
+```
+
+## Files
+
+| Path | Description |
+|---|---|
+| `multimeter.mmt` | Choices + presets; `path_from_os: $PATH`; live `session_*` → `./live_variables/…` |
+| `presets/` | Presets — `api_url.local` is `https://local.mmt.dev`, staging is `https://test.mmt.dev` |
+| `os_variables/` | OS `$PATH` echoed in the JSON **body** (not the URL) |
+| `live_variables/` | Live `./….mmt` getters ([docs](../../../docs/files/env/live-variables.md)) |
+| `suite.mmt` | Runs all three concepts |
+
+## Key concepts
+
+- **Presets** — `runner.dev` / `runner.staging` pick `api_url`, `mode`, `timeout`.
+- **`$PATH`** — OS ref; consumers use `e:path_from_os` in the body. See [OS variables](../../../docs/files/env/os-variables.md).
+- **`./….mmt`** — live getters; each `e:session_*` uses the target’s first `outputs:` key.
+- **`<<e:var>>`** / **`e:var`** — inline string vs whole-value (type-preserving) substitution.
+
+## How to use
+
+### In VS Code
+
+1. Open the folder (or repo) so `multimeter.mmt` loads as the workspace env.
+2. Pick a preset (e.g. `runner.dev`) in the Environment panel.
+3. Run `suite.mmt`, or files under `presets/`, `os_variables/`, `live_variables/`.
+4. `path_from_os` shows an `(os)` chip; live paths show `(live)`.
+
+### With the CLI
+
+```sh
+# Full suite
+npx testlight run examples/intermediate/10_environment_variables/suite.mmt \
+  --env-file examples/intermediate/10_environment_variables/multimeter.mmt \
+  --preset runner.dev
+
+# Presets only (local.mmt.dev in-process twin)
+npx testlight run examples/intermediate/10_environment_variables/presets/test/preset_test.mmt \
+  --env-file examples/intermediate/10_environment_variables/multimeter.mmt \
+  --preset runner.dev
+
+# OS PATH in the request body
+npx testlight run examples/intermediate/10_environment_variables/os_variables/path_test.mmt \
+  --env-file examples/intermediate/10_environment_variables/multimeter.mmt \
+  --preset runner.dev
+
+# Live variables
+npx testlight run examples/intermediate/10_environment_variables/live_variables/consume_session_test.mmt \
+  --env-file examples/intermediate/10_environment_variables/multimeter.mmt
+```
+
+Override a preset value:
+
+```sh
+npx testlight run examples/intermediate/10_environment_variables/presets/test/preset_test.mmt \
+  --env-file examples/intermediate/10_environment_variables/multimeter.mmt \
+  --preset runner.dev \
+  -e mode=release
+```

package/dist/examples/intermediate/{10_environment_presets → 10_environment_variables}/multimeter.mmt

@@ -1,7 +1,7 @@
 type: env
 variables:
   api_url:
-    local: "https://test.mmt.dev"
+    local: "https://local.mmt.dev"
     staging: "https://test.mmt.dev"
   mode:
     dev: debug
@@ -10,6 +10,11 @@ variables:
     - 5000
     - 10000
     - 30000
+  # OS process env — PATH exists on macOS, Linux, and Windows
+  path_from_os: $PATH
+  # Live file-backed values (run on each e: read)
+  session_api: ./live_variables/create_session_api.mmt
+  session_test: ./live_variables/create_session_test.mmt
 presets:
   runner:
     dev:

package/dist/examples/intermediate/10_environment_variables/os_variables/echo_path.mmt

@@ -0,0 +1,14 @@
+type: api
+title: Echo OS PATH
+description: Posts the host PATH (via e:path_from_os / $PATH) in the JSON body — not in the URL
+inputs:
+  note: from OS PATH
+outputs:
+  echoed_path: body.body.path
+  echoed_note: body.body.note
+url: <<e:api_url>>/echo
+method: post
+format: json
+body:
+  note: i:note
+  path: e:path_from_os

package/dist/examples/intermediate/10_environment_variables/os_variables/path_test.mmt

@@ -0,0 +1,13 @@
+type: test
+title: OS PATH env ref
+description: Reads $PATH through e:path_from_os and echoes it in the request body
+import:
+  echoOs: ./echo_path.mmt
+steps:
+  # Must be the real process PATH, not the literal `$PATH` string.
+  - check: <<e:path_from_os>> != $PATH
+  - check: <<e:path_from_os>> =* .
+  - call: echoOs
+    id: result
+    expect:
+      echoed_path: e:path_from_os

package/dist/examples/intermediate/10_environment_variables/suite.mmt

@@ -0,0 +1,9 @@
+type: suite
+title: Environment variables
+description: >
+  Preset consumer, OS $PATH body echo, and live ./….mmt session consumers.
+  runner.dev uses https://local.mmt.dev (in-process); live session_api hits test.mmt.dev.
+items:
+  - ./presets/test/preset_test.mmt
+  - ./os_variables/path_test.mmt
+  - ./live_variables/consume_session_test.mmt

package/dist/guides/generate-env.md

@@ -52,7 +52,7 @@ Env variables are **read in APIs/tests**, not stored as tokens here. In `type: a
 | `<<e:api_url>>` | Inside strings / URLs |
 | `e:city.latitude` / `<<e:city.latitude>>` | Property access on a nested choice value |
 
-The AI should not put `e:` tokens into env files; here we only define raw values or options.
+The AI should not put `e:` tokens into env files; here we only define raw values or options. Whole-value `$VAR` (OS process env) and `./….mmt` (live) are allowed as bare scalars or choice values — see [OS variables](../files/env/os-variables.md) and [Live variables](../files/env/live-variables.md).
 
 ---