run msbuild

Author: xieguigang

@export/index.d.ts

@@ -5,8 +5,9 @@
 declare namespace WorkflowRender {
    module _ {
       /**
+        * @param ssid default value Is ``null``.
       */
-      function get_context(): object;
+      function get_context(ssid?: any): object;
       /**
       */
       function internal_call(app: any, context: any): object;
@@ -52,8 +53,9 @@ declare namespace WorkflowRender {
    }
    /**
      * @param mounts default value Is ``null``.
+     * @param ssid default value Is ``null``.
    */
-   function create_memory_context(mounts?: any): object;
+   function create_memory_context(mounts?: any, ssid?: any): object;
    /**
    */
    function definePipeline(seq: any): object;
@@ -73,8 +75,9 @@ declare namespace WorkflowRender {
    function dependency_graph(mounts: any): object;
    /**
      * @param app default value Is ``null``.
+     * @param ssid default value Is ``null``.
    */
-   function echo_warning(msg: any, app?: any): object;
+   function echo_warning(msg: any, app?: any, ssid?: any): object;
    /**
    */
    function extract_workflow_vertex(meta: any): object;
@@ -83,8 +86,9 @@ declare namespace WorkflowRender {
    */
    function filepath_safe(dir: any, filename: any, maxchars?: any): object;
    /**
+     * @param ssid default value Is ``null``.
    */
-   function finalize(): object;
+   function finalize(ssid?: any): object;
    /**
    */
    function get_app_name(app: any): object;
@@ -115,15 +119,17 @@ declare namespace WorkflowRender {
    function hook(app: any): object;
    /**
      * @param outputdir default value Is ``./``.
+     * @param ssid default value Is ``null``.
    */
-   function init_context(outputdir?: any): object;
+   function init_context(outputdir?: any, ssid?: any): object;
    invalid_app_target: any;
    /**
    */
    function pull_configs(): object;
    /**
+     * @param ssid default value Is ``null``.
    */
-   function result_dir(): object;
+   function result_dir(ssid?: any): object;
    /**
      * @param registry default value Is ``null``.
      * @param disables default value Is ``Call "list"()``.
@@ -155,13 +161,16 @@ declare namespace WorkflowRender {
    */
    function use_cache(filepath: any, create: any): object;
    /**
+     * @param ssid default value Is ``null``.
    */
-   function workdir_root(): object;
+   function workdir_root(ssid?: any): object;
    /**
      * @param relpath default value Is ``null``.
+     * @param ssid default value Is ``null``.
    */
-   function workfile(app: any, relpath?: any): object;
+   function workfile(app: any, relpath?: any, ssid?: any): object;
    /**
+     * @param ssid default value Is ``null``.
    */
-   function workspace(app: any): object;
+   function workspace(app: any, ssid?: any): object;
 }

man/.get_context.1

@@ -1,15 +1,21 @@
 .TH .GET_CONTEXT 1 2025-Jun "" "get current workflow environment context"
 .SH NAME
-.get_context \- .get_context()
+.get_context \- .get_context(
+    <i>ssid</i> = <span style='color: blue !important;'>NULL</span>)
 .SH SYNOPSIS
-\fI.get_context()\fR
+\fI.get_context(
+    <i>ssid</i> = <span style='color: blue !important;'>NULL</span>)\fR
+.SH OPTIONS
+.PP
+\fBssid\fB \fR\- NULL. 
+.PP
 .SH VALUE
 .PP
 the context object which is generated via the ``init_context`` function.
 .PP
 .SH FILES
 .PP
-SMRUCC/R#.declare_function..get_context at context.R:line 74
+SMRUCC/R#.declare_function..get_context at context.R:line 78
 .PP
 .SH COPYRIGHT
 Copyright © xieguigang, MIT Licensed 2025

man/.internal_call.1

@@ -1,4 +1,4 @@
-.TH .INTERNAL_CALL 1 2025-Jun "internal" "@title Invoke an Analysis Application (Internal Function)"
+.TH .INTERNAL_CALL 1 2025-Jun "internal" ".internal_call"
 .SH NAME
 .internal_call \- .internal_call(app, context)
 .SH SYNOPSIS
@@ -22,6 +22,10 @@ Invisibly returns `NULL`. The function primarily updates `app$profiler` with exe
 .PP
 ### Key Steps: 1. ​**Dependency Check**: Validates if required context variables and files exist via `check_dependency(app, context)`. - If dependencies are met, proceeds to execute the application. - If dependencies are missing, throws an error with detailed missing resources. 2. ​**Execution**: - Logs start/end timestamps if `options(verbose = TRUE)`. - Executes `app$call` with arguments `app` and `context` using `do.call()`. 3. ​**Error Handling**: - Aggregates missing dependencies into readable error messages. - Calls `throw_err()` to terminate the workflow and report issues. 4. ​**Profiling**: Records total execution time in `app$profiler$time` using `time_span()` for human-readable formatting.
 .PP
+.SH EXAMPLES
+.PP
+\dontrun{ # Define a sample application app <- list( name = "demo_analysis", call = function(argv) { print(paste("Running:", argv$app$name)) }, profiler = list() ) # Execute with context .internal_call(app, context = list()) }
+.PP
 .SH FILES
 .PP
 SMRUCC/R#.declare_function..internal_call at runner.R:line 57

man/__build_app.1

@@ -7,10 +7,6 @@ __build_app \- __build_app(f)
 .PP
 \fBf\fB \fR\- . the target function f which tagged the required attribute data inside: app, desc, context_env, workfiles
 .PP
-.SH DETAILS
-.PP
-Build a new workflow app module object based on the custom attribute values that tagged on the target function
-.PP
 .SH FILES
 .PP
 SMRUCC/R#.declare_function.__build_app at reflection.R:line 11

man/__runImpl.1

@@ -5,10 +5,6 @@ __runImpl \- __runImpl(context,
 .SH SYNOPSIS
 \fI__runImpl(context,
     <i>disables</i> = 'list'())\fR
-.SH DESCRIPTION
-.PP
-An internal function that drives the execution of a modular workflow. It sequentially processes analysis modules according to the pipeline configuration while respecting disablement rules.
-.PP
 .SH OPTIONS
 .PP
 \fBcontext\fB \fR\- . A workflow context object containing: \itemize{ \item{pipeline - character vector of module execution order} \item{workflow - list of module definitions} }
@@ -24,6 +20,8 @@ Invisibly returns NULL. Modifies the workflow context object in-place through mo
 .PP
 This function: \enumerate{ \item Retrieves module execution order from `context$pipeline` \item Checks disablement status through two mechanisms: \itemize{ \item Explicit disablement via `disables` parameter \item Module's own `disable` property (set by upstream modules) } \item Executes non-disabled modules using `.internal_call()` \item Provides verbose logging when `options(verbose=TRUE)` } The workflow context is modified in-place by module execution.
 .PP
+.SH SEE ALSO
+\code{\link{.internal_call}} for module execution logic
 .SH FILES
 .PP
 SMRUCC/R#.declare_function.__runImpl at workflowRender.R:line 76

man/__workfile_uri_parser.1

@@ -5,7 +5,7 @@ __workfile_uri_parser \- __workfile_uri_parser(uri)
 \fI__workfile_uri_parser(uri)\fR
 .SH OPTIONS
 .PP
-\fBuri\fB \fR\- . a character vector that contains the workfile reference expression.
+\fBuri\fB \fR\- . 
 .PP
 .SH VALUE
 .PP

man/__workfiles.1

@@ -1,4 +1,4 @@
-.TH __WORKFILES 1 2025-Jun "" "parse the workfile expression"
+.TH __WORKFILES 1 2025-Jun "" "__workfiles"
 .SH NAME
 __workfiles \- __workfiles(files.uri)
 .SH SYNOPSIS

man/app.1

@@ -12,7 +12,7 @@ app \- app(name, analysis,
 \fBname\fB \fR\- . the analysis app name
 .PP
 .PP
-\fBanalysis\fB \fR\- . a callable function for run the data analysis content. The function declare signature for this parameter value required of two parameter signature, see comment document of the ``app_check.delegate`` function.
+\fBanalysis\fB \fR\- . 
 .PP
 .PP
 \fBdesc\fB \fR\- 'no description'. 

man/app_check.delegate.1

@@ -5,7 +5,7 @@ app_check.delegate \- app_check.delegate(analysis)
 \fIapp_check.delegate(analysis)\fR
 .SH OPTIONS
 .PP
-\fBanalysis\fB \fR\- . a callable function to check, just check of the required parameters is exists in the definition or not.
+\fBanalysis\fB \fR\- . 
 .PP
 .SH DETAILS
 .PP

man/app_check.signature.1

@@ -1,4 +1,4 @@
-.TH APP_CHECK.SIGNATURE 1 2025-Jun "" "check of the required app slot"
+.TH APP_CHECK.SIGNATURE 1 2025-Jun "" "app_check.signature"
 .SH NAME
 app_check.signature \- app_check.signature(app)
 .SH SYNOPSIS