Files
marqdo/lib/sys.mq.md
T
cflmyandCursor 67bac1bf02 feat(web): Document/Endpoint/Resource artifact rewrite (ADR 0007)
Replace the monolithic compose_*/configure author surface with file-level
web|endpoint artifacts, split ext/{web,data,security,net}, and lock
no-degrade rules so the model cannot regress to God-object APIs.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-28 11:06:38 +08:00

93 lines
1.7 KiB
Markdown

---
title: lib/sys
description: English system wrappers (load_dotenv accepts optional path via host alias)
---
English system wrappers (load_dotenv accepts optional path via host alias)
## env_get
+ `name`
Get environment variable name.
*> host_env_get name=`name`*
## env_set
+ `name`
+ `value`
Set environment variable name to value.
*> host_env_set name=`name` value=`value`*
## load_dotenv
+ `path`=None
Load `.env` (optional named arg `path=`). Existing process env is not overridden.
*> host_dotenv_load path=`path`*
## args
Process argv list.
*> host_args*
## cwd
Current working directory.
*> host_cwd*
## meta
Bound Artifact Metadata from the entry `.mq.md` (map). See `doc/design/binding.md`.
*> host_meta*
## meta_get
+ `key`
Lookup one metadata key; missing → None.
*> host_meta_get key=`key`*
## artifact_kind
Classify entry Artifact Metadata: `web` / `endpoint` / `prompt` / `other`, or None if no `type`/`类型`. ADR 0007.
*> host_artifact_kind*
## module_source
Entry `.mq.md` source text (for document-as-prompt). Empty string if unset.
*> host_module_source*
## exit
+ `code`
Exit process with code.
*> host_exit code=`code`*
## exec
+ `cmd`
+ `args`=None
+ `capture`=False
Run a process. Default return is the exit code (int).
With `capture=True`, return a map `{code, stdout, stderr}` (stdout/stderr may be truncated for huge output).
Inside `**…**` prefer bare `args=args` (variable); `` args=`args` `` is also accepted.
*> host_exec cmd=`cmd` args=`args` capture=`capture`*
## stream_publish
+ `event`
Publish a stream event map onto the process EventBus (`marqdo view` SSE). No-op when nothing is subscribed.
*> host_stream_publish event=`event`*