orbit-code-ai 0.1.0

package/_agent_reference/msgflow-xml-reference.md

@@ -0,0 +1,207 @@
+# Message Flow / Subflow XML Reference (Authoritative)
+
+Load this file before creating or editing any `.msgflow` or `.subflow` file. For node xmi:type prefixes not in the core table below, also load `node_types_extended.md`.
+
+## Message Flow (.msgflow) XML Format
+
+Message flows use a specific XML format based on EMF (Eclipse Modeling Framework):
+- Root element is always `<ecore:EPackage>` with required xmlns declarations
+- Each node type used MUST have a corresponding xmlns declaration in the root element
+- Built-in nodes: `ComIbmCompute.msgnode`, `ComIbmFilter.msgnode`, `ComIbmSOAPRequest.msgnode`, etc.
+- Framework subflow xmlns: path with "/" replaced by "_" for prefix, original path as value
+  Example: `xmlns:Qiwa_Framework_Lib_MQ_Input_Node.subflow="Qiwa/Framework/Lib/MQ_Input_Node.subflow"`
+- nsURI: file path with "/" separators. nsPrefix: same path with "/" replaced by "_"
+- Connections use `<connections xmi:type="eflow:FCMConnection">` with source/target terminal names
+- Subflow node terminals: InTerminal.Input / OutTerminal.Output (capital I and O)
+- Built-in node terminals: InTerminal.in / OutTerminal.out (lowercase)
+- .subflow files get `useDefaults="true" udpSupport="true"` on eClassifiers and have FCMSource/FCMSink terminals
+- .msgflow files do NOT have FCMSource/FCMSink
+
+### 6 Strict XML Rules for .msgflow/.subflow
+
+1. **Root element** must declare all required namespaces: xmlns:ecore, xmlns:xmi, xmlns:eflow, xmlns:utility — plus xmlns for EVERY node type used.
+2. **nsURI and nsPrefix** must match the namespace prefix used for each node type.
+3. **eClassifiers** must list the exact class name for every node type.
+4. **Node definitions**: Each node uses the namespace prefix of its node type:
+   - Compute: computeExpression="esql://routine/com.qiwa.esb.<pkg>#<Module>.Main"
+   - Filter: filterExpression="esql://routine/..."
+   - Framework subflows: xmi:type="<xmlns_prefix>:FCMComposite_1"
+   - Local subflows: xmi:type="com_qiwa_esb_<service>_<Name>.subflow:FCMComposite_1"
+5. **Connections**: source/target terminal names must exactly match the node type's declared terminals.
+6. **Terminal names must be exact**:
+   - Built-in nodes: InTerminal.in / OutTerminal.out (lowercase)
+   - Subflow nodes: InTerminal.Input / OutTerminal.Output (capital I and O)
+   - Filter: OutTerminal.true, OutTerminal.false, OutTerminal.unknown, OutTerminal.failure
+
+## ACE Built-in Node xmi:type Reference (Core — Most Common)
+
+**CRITICAL:** Before adding ANY node, verify its exact xmi:type namespace prefix from this list. The format is always `<prefix>:FCMComposite_1` in the xmi:type attribute of the `<nodes>` element. For async variants, TCPIP, FTE, JMS, Email, legacy ERP, MQTT, ODM, App Connect connectors — load `node_types_extended.md`.
+
+| Node Name | xmi:type namespace prefix |
+|---|---|
+| Subflow Input (FCMSource) | eflow:FCMSource |
+| Subflow Output (FCMSink) | eflow:FCMSink |
+| HTTP Input | ComIbmWSInput.msgnode |
+| HTTP Reply | ComIbmWSReply.msgnode |
+| HTTP Request | ComIbmWSRequest.msgnode |
+| HTTP Header | ComIbmHTTPHeader.msgnode |
+| MQ Input | ComIbmMQInput.msgnode |
+| MQ Output | ComIbmMQOutput.msgnode |
+| MQ Reply | ComIbmMQReply.msgnode |
+| MQ Get | ComIbmMQGet.msgnode |
+| Compute | ComIbmCompute.msgnode |
+| Filter | ComIbmFilter.msgnode |
+| Java Compute | ComIbmJavaCompute.msgnode |
+| Mapping (MSL) | ComIbmMSLMapping.msgnode |
+| JSONata Mapping | ComIbmJSONataMapping.msgnode |
+| XSL Transform | ComIbmXslMqsi.msgnode |
+| Reset Content Descriptor | ComIbmResetContentDescriptor.msgnode |
+| Route | ComIbmRoute.msgnode |
+| Route To Label | ComIbmRouteToLabel.msgnode |
+| Label | ComIbmLabel.msgnode |
+| Flow Order | ComIbmFlowOrder.msgnode |
+| Sequence | ComIbmSequence.msgnode |
+| Pass Through | ComIbmPassthru.msgnode |
+| Throw | ComIbmThrow.msgnode |
+| Try Catch | ComIbmTryCatch.msgnode |
+| Trace | ComIbmTrace.msgnode |
+| Validate | ComIbmValidate.msgnode |
+| Log | ComIbmLog.msgnode |
+| Callable Input | ComIbmCallableFlowInput.msgnode |
+| Callable Reply | ComIbmCallableFlowReply.msgnode |
+| Callable Flow Invoke | ComIbmCallableFlowInvoke.msgnode |
+| Aggregate Control | ComIbmAggregateControl.msgnode |
+| Aggregate Reply | ComIbmAggregateReply.msgnode |
+| Aggregate Request | ComIbmAggregateRequest.msgnode |
+| Collector | ComIbmCollector.msgnode |
+| Timeout Control | ComIbmTimeoutControl.msgnode |
+| Timeout Notification | ComIbmTimeoutNotification.msgnode |
+| Scheduler | ComIbmScheduler.msgnode |
+| Database Input | ComIbmDatabaseInput.msgnode |
+| Database | ComIbmDatabase.msgnode |
+| Database Retrieve | ComIbmDatabaseRetrieve.msgnode |
+| File Input | ComIbmFileInput.msgnode |
+| File Output | ComIbmFileOutput.msgnode |
+| Kafka Consumer | ComIbmKafkaMsgConsumer.msgnode |
+| Kafka Producer | ComIbmKafkaMsgProducer.msgnode |
+| REST Request | ComIbmRESTRequest.msgnode |
+| SOAP Input | ComIbmSOAPInput.msgnode |
+| SOAP Reply | ComIbmSOAPReply.msgnode |
+| SOAP Request | ComIbmSOAPRequest.msgnode |
+
+## Available Framework Subflows
+
+Always use these instead of building raw nodes:
+
+| Subflow | Purpose | Typical Properties |
+|---|---|---|
+| Qiwa.Framework.Lib:MQ_Input_Node | Standard MQ input with error handling | LOG_ENABLED, PROPERTIES_ENABLED, queueName, messageDomainProperty, PropertiesGroup, PropertyFilename |
+| Qiwa.Framework.Lib:MQ_Output_Node | Standard MQ output | queueName |
+| Qiwa.Framework.Lib:LogError | Structured error logging | (none) |
+| Qiwa.Framework.Lib:Rest_Input_Node | HTTP REST gateway entry | ServiceCallCorrIDOffset, Service_URL, waitInterval |
+| Qiwa.Framework.Lib:SOAP_Input_Node | SOAP gateway entry | (service-specific) |
+| Qiwa.Framework.Lib:Create_Response | Standard response builder | (service-specific) |
+| Qiwa.Framework.Lib:Validate_Request | Request schema validation | (service-specific) |
+| Qiwa.Framework.Lib:MWBusinessErrorResponse | Business error response handler | LOG_ENABLED, OUT_QUEUE |
+
+**Framework rule:** Always check the framework index before writing any ESQL or creating any flow node. If a framework subflow or function already does what is needed, use it — never reimplement it. Standard MQ input/output and error handling MUST use framework subflows.
+
+## Gateway Flow Pattern
+
+Every REST service has a Gateway flow (GW_<FlowName>.msgflow). This is always a simple two-node flow:
+1. **Rest_Input_Node** (framework subflow) — with Service_URL and waitInterval properties
+2. **LogError** (framework subflow) — for error handling
+
+**Connection:** Rest_Input_Node `OutTerminal.Output` → LogError `InTerminal.Input` (ONE connection only).
+
+**CRITICAL RULES for Gateway flows:**
+- Both nodes are framework SUBFLOWS, so terminals use CAPITAL letters: `OutTerminal.Output`, `InTerminal.Input`
+- Do NOT use `OutTerminal.failure` or `OutTerminal.catch` — those are built-in node terminals, not subflow terminals
+- There is only ONE connection between Rest_Input_Node and LogError
+- colorGraphic16 uses `platform:/plugin/<AppName>/icons/full/obj16/GW_<FlowName>.gif`
+- colorGraphic32 uses `platform:/plugin/<AppName>/icons/full/obj30/GW_<FlowName>.gif`
+
+**Complete correct Gateway flow XML example (GW_DateCalcTest.msgflow):**
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<ecore:EPackage xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI"
+    xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore"
+    xmlns:eflow="http://www.ibm.com/wbi/2005/eflow"
+    xmlns:utility="http://www.ibm.com/wbi/2005/eflow_utility"
+    xmlns:Qiwa_Framework_Lib_LogError.subflow="Qiwa/Framework/Lib/LogError.subflow"
+    xmlns:Qiwa_Framework_Lib_Rest_Input_Node.subflow="Qiwa/Framework/Lib/Rest_Input_Node.subflow"
+    nsURI="com/qiwa/esb/<servicename>/GW_<FlowName>.msgflow"
+    nsPrefix="com_qiwa_esb_<servicename>_GW_<FlowName>.msgflow">
+  <eClassifiers xmi:type="eflow:FCMComposite" name="FCMComposite_1">
+    <eSuperTypes href="http://www.ibm.com/wbi/2005/eflow#//FCMBlock"/>
+    <translation xmi:type="utility:TranslatableString" key="GW_<FlowName>"
+        bundleName="com/qiwa/esb/<servicename>/GW_<FlowName>" pluginId="<AppName>"/>
+    <colorGraphic16 xmi:type="utility:GIFFileGraphic" resourceName=
+        "platform:/plugin/<AppName>/icons/full/obj16/GW_<FlowName>.gif"/>
+    <colorGraphic32 xmi:type="utility:GIFFileGraphic" resourceName=
+        "platform:/plugin/<AppName>/icons/full/obj30/GW_<FlowName>.gif"/>
+    <composition>
+      <nodes xmi:type="Qiwa_Framework_Lib_Rest_Input_Node.subflow:FCMComposite_1"
+          xmi:id="FCMComposite_1_1" location="100,100" Service_URL="/<endpoint>">
+        <translation xmi:type="utility:ConstantString" string="Rest Input Node"/>
+      </nodes>
+      <nodes xmi:type="Qiwa_Framework_Lib_LogError.subflow:FCMComposite_1" xmi:id=
+          "FCMComposite_1_2" location="300,200">
+        <translation xmi:type="utility:ConstantString" string="LogError"/>
+      </nodes>
+      <connections xmi:type="eflow:FCMConnection" xmi:id="FCMConnection_2"
+          targetNode="FCMComposite_1_2" sourceNode="FCMComposite_1_1"
+          sourceTerminalName="OutTerminal.Output" targetTerminalName=
+          "InTerminal.Input"/>
+    </composition>
+    <propertyOrganizer/>
+    <stickyBoard/>
+  </eClassifiers>
+</ecore:EPackage>
+```
+
+**Key points in the example above:**
+- xmlns prefix uses `_` separator: `Qiwa_Framework_Lib_LogError.subflow`
+- xmlns value uses `/` separator: `Qiwa/Framework/Lib/LogError.subflow`
+- Connection uses `OutTerminal.Output` (capital O) because Rest_Input_Node is a subflow
+- Connection uses `InTerminal.Input` (capital I) because LogError is a subflow
+- Only ONE connection between the two nodes
+- colorGraphic paths use `platform:/plugin/<AppName>/...`
+
+## Main Flow Pattern
+Main processing flows use:
+1. MQ_Input_Node (framework) as entry point — reads from request queue
+2. Application subflows for business logic (validation, transformation, backend calls)
+3. Compute/Filter nodes for ESQL transformations
+4. MQ_Output_Node (framework) as success exit — writes to response queue
+5. MWBusinessErrorResponse (framework) as error exit
+
+## Standard Message Structure (Always Required)
+
+```xml
+<Root>
+  <Header>
+    <TransactionId/>
+    <ChannelId/>
+    <ChannelUserInfo>
+      <UserName/>
+      <UserPassword/>   <!-- always mask in audit -->
+    </ChannelUserInfo>
+    <ServiceCode/>
+    <SessionId/>
+    <RequestTime/>
+    <ResponseStatus>
+      <Code/>
+      <Status/>         <!-- Success | Error -->
+      <EnglishMsg/>
+    </ResponseStatus>
+  </Header>
+  <Body/>
+</Root>
+```
+
+## Key Constants (from CommonUtils.esql)
+- Success code: `'00000000'`
+- Technical error: `'99999999'`
+- DB error: `'E0199998'`
+- Namespace: `Qiwa.Framework.Lib`

package/_agent_reference/node_types_extended.md

@@ -0,0 +1,211 @@
+# ACE Node xmi:type Reference — Extended (Rare & Connector Nodes)
+
+**Load this file** when working with async patterns, legacy ERP integrations, TCPIP/FTE, MQTT, App Connect connectors, or any node not found in the core table in the system prompt.
+
+---
+
+## Rarely-Used Built-in Nodes
+
+| Node Name | xmi:type namespace prefix |
+|---|---|
+| HTTP Async Request | ComIbmHTTPAsyncRequest.msgnode |
+| HTTP Async Response | ComIbmHTTPAsyncResponse.msgnode |
+| MQ Header | ComIbmMQHeader.msgnode |
+| Publication | ComIbmPublication.msgnode |
+| .NET Compute | ComIbmDotNetCompute.msgnode |
+| .NET Input | ComIbmDotNetInput.msgnode |
+| Resequence | ComIbmReSequence.msgnode |
+| Group Scatter | ComIbmGroupScatter.msgnode |
+| Group Gather | ComIbmGroupGather.msgnode |
+| Group Complete | ComIbmGroupComplete.msgnode |
+| Callable Flow Async Invoke | ComIbmCallableFlowAsyncInvoke.msgnode |
+| Callable Flow Async Response | ComIbmCallableFlowAsyncResponse.msgnode |
+| Security PEP | ComIbmSecurityPEP.msgnode |
+| SOAP Async Request | ComIbmSOAPAsyncRequest.msgnode |
+| SOAP Async Response | ComIbmSOAPAsyncResponse.msgnode |
+| SOAP Envelope | ComIbmSOAPEnvelope.msgnode |
+| SOAP Extract | ComIbmSOAPExtract.msgnode |
+| REST Async Request | ComIbmRESTAsyncRequest.msgnode |
+| REST Async Response | ComIbmRESTAsyncResponse.msgnode |
+| App Connect REST Request | ComIbmAppConnectRESTRequest.msgnode |
+| Database Route | ComIbmDatabaseRoute.msgnode |
+| Change Data Capture | ComIbmChangeDataCapture.msgnode |
+| File Read | ComIbmFileRead.msgnode |
+| File Exists | ComIbmFileExists.msgnode |
+| File Iterator | ComIbmFileIterator.msgnode |
+| Email Input | ComIbmEmailInput.msgnode |
+| Email Output | ComIbmEmailOutput.msgnode |
+| JMS Input | ComIbmJMSClientInput.msgnode |
+| JMS Output | ComIbmJMSClientOutput.msgnode |
+| JMS Reply | ComIbmJMSClientReply.msgnode |
+| JMS Receive | ComIbmJMSClientReceive.msgnode |
+| JMS Header | ComIbmJMSHeader.msgnode |
+| Kafka Read | ComIbmKafkaMsgRead.msgnode |
+| TCPIP Client Input | ComIbmTCPIPClientInput.msgnode |
+| TCPIP Client Output | ComIbmTCPIPClientOutput.msgnode |
+| TCPIP Client Receive | ComIbmTCPIPClientReceive.msgnode |
+| TCPIP Server Input | ComIbmTCPIPServerInput.msgnode |
+| TCPIP Server Output | ComIbmTCPIPServerOutput.msgnode |
+| TCPIP Server Receive | ComIbmTCPIPServerReceive.msgnode |
+| FTE Input | ComIbmFTEInput.msgnode |
+| FTE Output | ComIbmFTEOutput.msgnode |
+| ODM Rules | ComIbmODMRules.msgnode |
+| CICS Request | ComIbmCICSIPICRequest.msgnode |
+| IMS Request | ComIbmIMSRequest.msgnode |
+| CORBA Request | ComIbmCORBARequest.msgnode |
+| SAP Input | ComIbmSAPInput.msgnode |
+| SAP Request | ComIbmSAPRequest.msgnode |
+| SAP Reply | ComIbmSAPReply.msgnode |
+| JDEdwards Input | ComIbmJDEdwardsInput.msgnode |
+| JDEdwards Request | ComIbmJDEdwardsRequest.msgnode |
+| PeopleSoft Input | ComIbmPeopleSoftInput.msgnode |
+| PeopleSoft Request | ComIbmPeopleSoftRequest.msgnode |
+| Siebel Input | ComIbmSiebelInput.msgnode |
+| Siebel Request | ComIbmSiebelRequest.msgnode |
+| CD Input | ComIbmCDInput.msgnode |
+| CD Output | ComIbmCDOutput.msgnode |
+| Registry Lookup | SRRetrieveEntity.msgnode |
+| Endpoint Lookup | SRRetrieveITService.msgnode |
+| MQTT Subscribe | com_ibm_connector_mqtt_ComIbmEventInput.msgnode (connectorName="MQTT") |
+| MQTT Publish | com_ibm_connector_mqtt_ComIbmOutput.msgnode (connectorName="MQTT") |
+| Loop Back Request | com_ibm_connector_loopback_ComIbmRequest.msgnode (connectorName="iib-loopback-connector") |
+| Salesforce Request (no discovery) | com_ibm_connector_salesforce_ComIbmRequest.msgnode (connectorName="iib-salesforce-connector") |
+
+---
+
+## Application Connector Nodes
+
+**Pattern:** `ComIbmApplicationConnectorRequest_<type>.msgnode` or `ComIbmApplicationConnectorInput_<type>.msgnode` plus `applicationConnectorType="<type>"`.
+
+| Connector | type value |
+|---|---|
+| Amazon CloudWatch | amazoncloudwatch |
+| Amazon DynamoDB | amazondynamodb |
+| Amazon EC2 | amazonec2 |
+| Amazon EventBridge | amazoneventbridge |
+| Amazon Kinesis | amazonkinesis |
+| Amazon Lambda | amazonlambda |
+| Amazon RDS | amazonrds |
+| Amazon S3 | amazons3 |
+| Amazon SES | amazonses |
+| Amazon SNS | amazonsns |
+| Amazon SQS | amazonsqs |
+| Apache Pulsar | apachepulsar |
+| Asana | asana |
+| Astra DB | astradb |
+| Azure Blob Storage | azureblobstorage |
+| Azure Cosmos DB | azurecosmosdb |
+| Azure DevOps | azuredevops |
+| Azure Event Hubs | azureeventhub |
+| Azure OpenAI | azureopenai |
+| Azure Service Bus | azureservicebus |
+| Azure Entra ID (AD) | azuread |
+| BambooHR | bamboohr |
+| Box | box |
+| Businessmap | businessmap |
+| Calendly | calendly |
+| ClickSend | clicksend |
+| CMIS | cmis |
+| Confluence | confluence |
+| Couchbase | couchbase |
+| Coupa | coupa |
+| Crystal Ball | crystalball |
+| Databricks | databricks |
+| DocuSign | docusign |
+| Dropbox | dropbox |
+| Eventbrite | eventbrite |
+| Expensify | expensify |
+| Factorial HR | factorialhr |
+| Freshservice | freshservice |
+| Front | front |
+| GitHub | github |
+| GitLab | gitlab |
+| Gmail | gmail |
+| Google Analytics 4 | googleanalytics4 |
+| Google Calendar | googlecalendar |
+| Google Chat | googlechat |
+| Google BigQuery | googlebigquery |
+| Google Cloud PubSub | googlepubsub |
+| Google Cloud Storage | googlecloudstorage |
+| Google Contacts | googlecontacts |
+| Google Drive | googledrive |
+| Google Gemini | googlegemini |
+| Google Groups | googlegroups |
+| Google Sheets | googlesheet |
+| Google Tasks | googletasks |
+| Google Translate | googletranslate |
+| Greenhouse | greenhouse |
+| HubSpot CRM | hubspotcrm |
+| HubSpot Marketing | hubspotmarketing |
+| Hunter | hunter |
+| IBM Aspera | ibmaspera |
+| IBM Cloud Object Storage S3 | ibmcoss3 |
+| IBM Cloudant | cloudantdb |
+| IBM EWM | ibmewm |
+| IBM FileNet | filenet |
+| IBM Food Trust | ift |
+| IBM Maximo | maximo |
+| IBM OpenPages | ibmopenpages |
+| IBM Planning Analytics | planninganalytics |
+| IBM Sterling IV | ibmsterlingiv |
+| IBM Targetprocess | apptiotargetprocess |
+| IBM Watson Discovery | watsondiscovery |
+| IBM watsonx.ai | ibmwatsonxai |
+| IBM zOS Connect | zosconnect |
+| Infobip | infobip |
+| Insightly | insightly |
+| Jenkins | jenkins |
+| Jira | jira |
+| LDAP | ldap |
+| Magento | magento |
+| Mailchimp | mailchimp |
+| Marketo | marketo |
+| Microsoft Active Directory | msad |
+| Microsoft Dynamics 365 Finance | msdynamicsfando |
+| Microsoft Dynamics 365 Sales | msdynamicscrmrest |
+| Microsoft Excel Online | msexcel |
+| Microsoft Exchange | msexchange |
+| Microsoft OneDrive | msonedrive |
+| Microsoft OneNote | msonenote |
+| Microsoft Power BI | mspowerbi |
+| Microsoft SharePoint | mssharepoint |
+| Microsoft Teams | msteams |
+| Microsoft To Do | mstodo |
+| Microsoft Viva Engage | yammer |
+| Milvus | milvus |
+| monday.com | mondaydotcom |
+| Oracle E-Business Suite | oracleebs |
+| Oracle HCM | oraclehcm |
+| Pinecone | pineconedb |
+| Redis | rediscache |
+| Salesforce | salesforce |
+| Salesforce Account Engagement | salesforceae |
+| Salesforce Commerce Cloud | sfcommerceclouddata |
+| Salesforce Marketing Cloud | salesforcemc |
+| SAP OData | sapodata |
+| SAP Ariba | sapariba |
+| SAP S4 HANA | saps4hana |
+| SAP SuccessFactors | sapsuccessfactors |
+| ServiceNow | servicenow |
+| Shopify | shopify |
+| Slack | slack |
+| Snowflake | snowflake |
+| Splunk | splunk |
+| Square | square |
+| SurveyMonkey | surveymonkey |
+| The Weather Company | ibmtwc |
+| Toggl Track | toggltrack |
+| Trello | trello |
+| Twilio | twilio |
+| UKG (Kronos) | kronos |
+| Vespa | vespa |
+| WordPress | wordpress |
+| Workday | workday |
+| Wrike | wrike |
+| Wufoo | wufoo |
+| Yapily | yapily |
+| Zendesk Service | zendeskservice |
+| Zoho Books | zohobooks |
+| Zoho CRM | zohocrm |
+| Zoho Inventory | zohoinventory |
+| Zoho Recruit | zohorecruit |

package/_agent_reference/templates/file-flow.md

@@ -0,0 +1,212 @@
+# Template: File Input/Output Flow
+
+Use this template when building a flow triggered by a file drop, or that writes output to the file system (batch processing, file-based integrations).
+
+---
+
+## Files to Create
+
+```
+MyServiceApp/
+├── .project
+├── ProcessMyFile.msgflow
+├── ProcessMyFile_Compute.esql
+├── ProcessMyFile_MapOutput.esql
+└── MyFile.xsd                     ← optional: schema for validation
+```
+
+---
+
+## Message Flow Structure (ProcessMyFile.msgflow)
+
+### File Input → Backend → File Output
+
+```
+[File_Input_Node]        ← reads file from directory
+      ↓ out
+[PropertyReader]         ← ApplicationLabel="BS_MyService", PropertiesFileName="MYSERVICE-PROPERTIES.xml"
+      ↓ out
+[LogAudit]               ← flowStart=TRUE
+      ↓ out
+[ProcessMyFile_Compute]  ← parse/validate file content, prepare backend call
+      ↓ out
+[HTTPRequestAdapter]     ← optional: call backend (if needed)
+      ↓ out
+[HTTPResponseAdapter]    ← optional
+      ↓ out
+[ProcessMyFile_MapOutput] ← format output data
+      ↓ out
+[LogOutgoingAudit]       ← flowStart=FALSE
+      ↓ out
+[File_Output_Node]       ← write result file
+
+All failure terminals → [ErrorHandler] → [LogError] → [MQ_Dead_Output_Node]
+```
+
+### File Input → MQ Output (trigger pattern)
+
+```
+[File_Input_Node]
+      ↓ out
+[PropertyReader]
+      ↓ out
+[LogAudit]
+      ↓ out
+[ProcessMyFile_Compute]  ← convert file to ESB message format
+      ↓ out
+[LogOutgoingAudit]
+      ↓ out
+[MQ_Output_Node]         ← push to MQ for downstream processing
+```
+
+---
+
+## ProcessMyFile_Compute.esql
+
+```esql
+BROKER SCHEMA Qiwa.BS_MyService
+
+CREATE COMPUTE MODULE ProcessMyFile_Compute
+    CREATE FUNCTION Main() RETURNS BOOLEAN
+    BEGIN
+        CALL CopyMessageHeaders();
+        CALL CopyEntireMessage();
+
+        -- File content arrives in InputRoot.MRM (if using MRM domain)
+        -- or InputRoot.XMLNSC (if XML file with XMLNSC domain)
+        -- or InputRoot.BLOB.BLOB (raw binary)
+
+        -- Example: parse a delimited file record
+        DECLARE recordCount INT CARDINALITY(InputRoot.MRM.Record[]);
+        DECLARE i INT 1;
+
+        WHILE i <= recordCount DO
+            -- Process each record
+            DECLARE customerId CHARACTER InputRoot.MRM.Record[i].CustomerId;
+            -- ... your logic
+            SET i = i + 1;
+        END WHILE;
+
+        RETURN TRUE;
+    END;
+END MODULE;
+```
+
+---
+
+## ProcessMyFile_MapOutput.esql
+
+```esql
+BROKER SCHEMA Qiwa.BS_MyService
+
+CREATE COMPUTE MODULE ProcessMyFile_MapOutput
+    CREATE FUNCTION Main() RETURNS BOOLEAN
+    BEGIN
+        CALL CopyMessageHeaders();
+
+        -- Build output file content
+        -- For XML output:
+        SET OutputRoot.XMLNSC.OutputFile.ProcessedDate = CURRENT_TIMESTAMP;
+        SET OutputRoot.XMLNSC.OutputFile.RecordCount   = Environment.ProcessedCount;
+        -- ... map output fields
+
+        -- For File_Output_Node: set target filename
+        SET OutputRoot.ComIbmFileHeader.Filename =
+            'output_' || CAST(CURRENT_TIMESTAMP AS CHARACTER FORMAT 'yyyyMMddHHmmss') || '.xml';
+
+        RETURN TRUE;
+    END;
+END MODULE;
+```
+
+---
+
+## File_Input_Node Configuration
+
+Set at the node level in the message flow:
+
+| Property | Example Value | Notes |
+|---|---|---|
+| `Directory` | `/data/input/myservice` | Input directory to watch |
+| `Filename` | `*.xml` or `*.csv` | File pattern to pick up |
+| `FileSuffix` | `.xml` | Alternative to Filename pattern |
+| `Delete` | `YES` | Delete file after pickup |
+| `RecordDefinition` | (MRM message set) | For structured/delimited files |
+
+---
+
+## File_Output_Node Configuration
+
+| Property | Example Value | Notes |
+|---|---|---|
+| `Directory` | `/data/output/myservice` | Output directory |
+| `Filename` | Set dynamically in ESQL | Or fixed filename |
+| `WriteMode` | `WRITE` | WRITE (overwrite) or APPEND |
+
+---
+
+## MYSERVICE-PROPERTIES.xml (File variant)
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<properties refresh-policy="automatic">
+
+  <group name="BS_MyService.ProcessMyFile">
+
+    <group name="Logging">
+      <property name="LogEnabled"     value="TRUE" />
+      <property name="AuditEnabled"   value="TRUE" />
+      <property name="MaskingEnabled" value="FALSE" />
+      <property name="key1"   value="FILE.NAME" />
+      <property name="value1" value="*.ComIbmFileHeader.Filename" />
+    </group>
+
+    <group name="Retry">
+      <property name="RetryEnabled"       value="TRUE" />
+      <property name="maxRetryCount"      value="3" />
+      <property name="minWaitDurationSec" value="300" />
+    </group>
+
+    <group name="SchemaValidation">
+      <property name="ValidationEnabled" value="FALSE" />
+    </group>
+
+    <group name="Priority">
+      <property name="Priority" value="4" />
+    </group>
+
+  </group>
+
+</properties>
+```
+
+---
+
+## FileCopy.subflow
+
+For simple file routing/archival within a flow:
+
+```
+[File_Input_Node]
+      ↓
+[FileCopy]              ← copy to archive directory before processing
+      ↓
+[ProcessMyFile_Compute]
+      ↓
+[File_Output_Node]
+```
+
+---
+
+## Checklist for New File Flow
+
+- [ ] Create `.msgflow` with `File_Input_Node` as entry point
+- [ ] Set input directory, filename pattern, and delete flag on `File_Input_Node`
+- [ ] Create Compute ESQL for file parsing/processing logic
+- [ ] Create MapOutput ESQL for output formatting
+- [ ] Add properties group to properties XML file
+- [ ] Wire ALL failure terminals to `ErrorHandler` → `LogError` → `MQ_Dead_Output_Node`
+- [ ] Set `ApplicationLabel` and `PropertiesFileName` on `PropertyReader` node
+- [ ] Set output filename dynamically in `MapOutput` ESQL
+- [ ] Consider `FileCopy` for archiving input before processing
+- [ ] If schema validation needed: set `ValidationEnabled=TRUE` and provide XSD