[{"data":1,"prerenderedAt":4728},["ShallowReactive",2],{"navigation_docs":3,"-docs-guides-creating-go-module":968,"-docs-guides-creating-go-module-surround":4723},[4,27,63,129,287,311,893,902,950,964],{"title":5,"path":6,"stem":7,"children":8,"order":10,"icon":11},"Overview","\u002Fdocs\u002Foverview","docs\u002F1.overview\u002Findex",[9,12,18,24],{"title":5,"path":6,"stem":7,"order":10,"icon":11},1,"i-lucide-info",{"title":13,"path":14,"stem":15,"order":16,"icon":17},"Getting Started","\u002Fdocs\u002Foverview\u002Fgetting-started","docs\u002F1.overview\u002F2.getting-started",2,"i-lucide-rocket",{"title":19,"path":20,"stem":21,"order":22,"icon":23},"Contributing","\u002Fdocs\u002Foverview\u002Fcontributing","docs\u002F1.overview\u002F3.contributing",3,"i-lucide-heart",{"title":5,"path":25,"stem":26,"order":10},"\u002Fdocs\u002Foverview\u002F_dir","docs\u002F1.overview\u002F_dir",{"title":28,"path":29,"stem":30,"children":31,"page":62},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002F2.concepts",[32,37,42,47,53,59],{"title":33,"path":34,"stem":35,"order":10,"icon":36},"Events","\u002Fdocs\u002Fconcepts\u002Fevents","docs\u002F2.concepts\u002F1.events","i-lucide-zap",{"title":38,"path":39,"stem":40,"order":16,"icon":41},"Transports","\u002Fdocs\u002Fconcepts\u002Ftransports","docs\u002F2.concepts\u002F2.transports","i-lucide-network",{"title":43,"path":44,"stem":45,"order":22,"icon":46},"Module System","\u002Fdocs\u002Fconcepts\u002Fmodules","docs\u002F2.concepts\u002F3.modules","i-lucide-puzzle",{"title":48,"path":49,"stem":50,"order":51,"icon":52},"Flows","\u002Fdocs\u002Fconcepts\u002Fflows","docs\u002F2.concepts\u002F4.flows",4,"i-lucide-workflow",{"title":54,"path":55,"stem":56,"order":57,"icon":58},"Scheduler","\u002Fdocs\u002Fconcepts\u002Fscheduler","docs\u002F2.concepts\u002F5.scheduler",5,"i-lucide-clock",{"title":28,"path":60,"stem":61,"order":16},"\u002Fdocs\u002Fconcepts\u002F_dir","docs\u002F2.concepts\u002F_dir",false,{"title":64,"path":65,"stem":66,"children":67,"page":62},"Guides","\u002Fdocs\u002Fguides","docs\u002F3.guides",[68,73,77,81,85,89,93,98,104,110,116,122,126],{"title":69,"path":70,"stem":71,"order":10,"icon":72},"Creating a Go App","\u002Fdocs\u002Fguides\u002Fcreating-go-app","docs\u002F3.guides\u002F1.creating-go-app","i-lucide-terminal",{"title":74,"path":75,"stem":76},"E2E tests & demo videos","\u002Fdocs\u002Fguides\u002Fe2e-and-demo-videos","docs\u002F3.guides\u002F10.e2e-and-demo-videos",{"title":78,"path":79,"stem":80,"icon":17},"Deploying to production","\u002Fdocs\u002Fguides\u002Fdeploying-to-production","docs\u002F3.guides\u002F11.deploying-to-production",{"title":82,"path":83,"stem":84,"order":16,"icon":46},"Creating a Go Module","\u002Fdocs\u002Fguides\u002Fcreating-go-module","docs\u002F3.guides\u002F2.creating-go-module",{"title":86,"path":87,"stem":88,"order":22,"icon":36},"Adding Events","\u002Fdocs\u002Fguides\u002Fadding-events-to-go-module","docs\u002F3.guides\u002F3.adding-events-to-go-module",{"title":90,"path":91,"stem":92,"order":51,"icon":52},"FlowDSL to Service","\u002Fdocs\u002Fguides\u002Fflowdsl-to-redelay","docs\u002F3.guides\u002F4.flowdsl-to-redelay",{"title":94,"path":95,"stem":96,"order":57,"icon":97},"Choosing a Transport","\u002Fdocs\u002Fguides\u002Fchoosing-a-transport","docs\u002F3.guides\u002F5.choosing-a-transport","i-lucide-git-branch",{"title":99,"path":100,"stem":101,"order":102,"icon":103},"Module Browser (\u002Fmodules)","\u002Fdocs\u002Fguides\u002Fmodules-browser","docs\u002F3.guides\u002F6.modules-browser",6,"i-lucide-layout-dashboard",{"title":105,"path":106,"stem":107,"order":108,"icon":109},"Running Flows","\u002Fdocs\u002Fguides\u002Frunning-flows","docs\u002F3.guides\u002F7.running-flows",7,"i-lucide-play-circle",{"title":111,"path":112,"stem":113,"order":114,"icon":115},"Trace + Live Observability","\u002Fdocs\u002Fguides\u002Fobservability","docs\u002F3.guides\u002F8.observability",8,"i-lucide-activity",{"title":117,"path":118,"stem":119,"order":120,"icon":121},"Project AI Assistant","\u002Fdocs\u002Fguides\u002Fai-assistant","docs\u002F3.guides\u002F9.ai-assistant",9,"i-lucide-sparkles",{"title":123,"path":124,"stem":125},"Debug taps — trace live data through any node","\u002Fdocs\u002Fguides\u002Fdebug-taps","docs\u002F3.guides\u002F9.debug-taps",{"title":64,"path":127,"stem":128,"order":22},"\u002Fdocs\u002Fguides\u002F_dir","docs\u002F3.guides\u002F_dir",{"title":130,"path":131,"stem":132,"children":133,"page":62},"Reference","\u002Fdocs\u002Freference","docs\u002F4.reference",[134,139,143,148,153,158,163,168,172,177,182,187,193,199,205,210,215,219,225,230,236,242,247,253,259,263,267,273,278,284],{"title":135,"path":136,"stem":137,"order":10,"icon":138},"Go Framework","\u002Fdocs\u002Freference\u002Fgo-framework","docs\u002F4.reference\u002F01.go-framework","i-simple-icons-go",{"title":140,"path":141,"stem":142,"order":16,"icon":46},"Built-in Modules","\u002Fdocs\u002Freference\u002Fgo-modules","docs\u002F4.reference\u002F02.go-modules",{"title":144,"path":145,"stem":146,"order":22,"icon":147},"Domain Addon Modules","\u002Fdocs\u002Freference\u002Fgo-modules-addons","docs\u002F4.reference\u002F03.go-modules-addons","i-lucide-blocks",{"title":149,"path":150,"stem":151,"order":51,"icon":152},"Go Events","\u002Fdocs\u002Freference\u002Fgo-events","docs\u002F4.reference\u002F04.go-events","i-lucide-radio",{"title":154,"path":155,"stem":156,"order":57,"icon":157},"Email Module","\u002Fdocs\u002Freference\u002Fgo-module-email","docs\u002F4.reference\u002F05.go-module-email","i-lucide-mail",{"title":159,"path":160,"stem":161,"order":102,"icon":162},"Go Core & IR","\u002Fdocs\u002Freference\u002Fgo-core","docs\u002F4.reference\u002F06.go-core","i-lucide-cpu",{"title":164,"path":165,"stem":166,"order":108,"icon":167},"Module Definition Files","\u002Fdocs\u002Freference\u002Fgo-module-files","docs\u002F4.reference\u002F07.go-module-files","i-lucide-file-code",{"title":169,"path":170,"stem":171,"order":114,"icon":72},"CLI Reference","\u002Fdocs\u002Freference\u002Fgo-cli","docs\u002F4.reference\u002F08.go-cli",{"title":173,"path":174,"stem":175,"order":120,"icon":176},"Go Formats","\u002Fdocs\u002Freference\u002Fgo-formats","docs\u002F4.reference\u002F09.go-formats","i-lucide-file-json",{"title":178,"path":179,"stem":180,"order":181,"icon":152},"AsyncAPI Module","\u002Fdocs\u002Freference\u002Fgo-asyncapi","docs\u002F4.reference\u002F10.go-asyncapi",10,{"title":183,"path":184,"stem":185,"order":186,"icon":52},"Go FlowDSL","\u002Fdocs\u002Freference\u002Fgo-flowdsl","docs\u002F4.reference\u002F11.go-flowdsl",11,{"title":188,"path":189,"stem":190,"order":191,"icon":192},"FlowDSL Examples","\u002Fdocs\u002Freference\u002Fflowdsl-examples","docs\u002F4.reference\u002F12.flowdsl-examples",12,"i-lucide-file-code-2",{"title":194,"path":195,"stem":196,"order":197,"icon":198},"FlowDSL Sync","\u002Fdocs\u002Freference\u002Fflowdsl-sync","docs\u002F4.reference\u002F13.flowdsl-sync",13,"i-lucide-refresh-cw",{"title":200,"path":201,"stem":202,"order":203,"icon":204},"Node.js Framework","\u002Fdocs\u002Freference\u002Fjs-framework","docs\u002F4.reference\u002F14.js-framework",14,"i-simple-icons-nodedotjs",{"title":206,"path":207,"stem":208,"order":203,"icon":209},"Python Framework","\u002Fdocs\u002Freference\u002Fpy-framework","docs\u002F4.reference\u002F14.py-framework","i-simple-icons-python",{"title":211,"path":212,"stem":213,"order":214,"icon":204},"Node.js Events","\u002Fdocs\u002Freference\u002Fjs-events","docs\u002F4.reference\u002F15.js-events",15,{"title":216,"path":217,"stem":218,"order":214,"icon":209},"Python Events","\u002Fdocs\u002Freference\u002Fpy-events","docs\u002F4.reference\u002F15.py-events",{"title":220,"path":221,"stem":222,"order":223,"icon":224},"go-ai — LLM Providers, Guard, Ledger","\u002Fdocs\u002Freference\u002Fgo-ai","docs\u002F4.reference\u002F16.go-ai",16,"i-lucide-brain-circuit",{"title":226,"path":227,"stem":228,"order":229,"icon":41},"Infrastructure Modules","\u002Fdocs\u002Freference\u002Fgeneric-infra-modules","docs\u002F4.reference\u002F17.generic-infra-modules",17,{"title":231,"path":232,"stem":233,"order":234,"icon":235},"Flow Templates","\u002Fdocs\u002Freference\u002Fflow-templates","docs\u002F4.reference\u002F18.flow-templates",18,"i-lucide-library-big",{"title":237,"path":238,"stem":239,"order":240,"icon":241},"Assistant (chat + handoff)","\u002Fdocs\u002Freference\u002Fassistant","docs\u002F4.reference\u002F19.assistant",19,"i-lucide-messages-square",{"title":243,"path":244,"stem":245,"order":246,"icon":41},"Coordination","\u002Fdocs\u002Freference\u002Fcoordination","docs\u002F4.reference\u002F20.coordination",20,{"title":248,"path":249,"stem":250,"order":251,"icon":252},"Search (vector)","\u002Fdocs\u002Freference\u002Fsearch","docs\u002F4.reference\u002F21.search",21,"i-lucide-search",{"title":254,"path":255,"stem":256,"order":257,"icon":258},"Profiles","\u002Fdocs\u002Freference\u002Fprofiles","docs\u002F4.reference\u002F22.profiles",22,"i-lucide-bookmark",{"title":260,"path":261,"stem":262},"Flow-driven HTTP endpoints","\u002Fdocs\u002Freference\u002Fflow-driven-endpoints","docs\u002F4.reference\u002F23.flow-driven-endpoints",{"title":264,"path":265,"stem":266},"Deployments","\u002Fdocs\u002Freference\u002Fdeployments","docs\u002F4.reference\u002F24.deployments",{"title":268,"path":269,"stem":270,"order":271,"icon":272},"i18n (translations)","\u002Fdocs\u002Freference\u002Fi18n","docs\u002F4.reference\u002F25.i18n",25,"i-lucide-languages",{"title":274,"path":275,"stem":276,"order":277,"icon":152},"WebSockets","\u002Fdocs\u002Freference\u002Fwebsockets","docs\u002F4.reference\u002F26.websockets",26,{"title":279,"path":280,"stem":281,"order":282,"icon":283},"Localized content","\u002Fdocs\u002Freference\u002Flocalized-content","docs\u002F4.reference\u002F27.localized-content",27,"i-lucide-file-text",{"title":130,"path":285,"stem":286,"order":51},"\u002Fdocs\u002Freference\u002F_dir","docs\u002F4.reference\u002F_dir",{"title":288,"path":289,"stem":290,"children":291,"page":62},"Integrations","\u002Fdocs\u002Fintegrations","docs\u002F5.integrations",[292,296,300,304,308],{"title":293,"path":294,"stem":295,"order":10,"icon":52},"FlowDSL","\u002Fdocs\u002Fintegrations\u002Fflowdsl","docs\u002F5.integrations\u002F1.flowdsl",{"title":297,"path":298,"stem":299,"order":16,"icon":283},"OpenAPI","\u002Fdocs\u002Fintegrations\u002Fopenapi","docs\u002F5.integrations\u002F2.openapi",{"title":301,"path":302,"stem":303,"order":22,"icon":152},"AsyncAPI","\u002Fdocs\u002Fintegrations\u002Fasyncapi","docs\u002F5.integrations\u002F3.asyncapi",{"title":305,"path":306,"stem":307},"MCP Integration","\u002Fdocs\u002Fintegrations\u002Fmcp","docs\u002F5.integrations\u002F4.mcp",{"title":288,"path":309,"stem":310,"order":57},"\u002Fdocs\u002Fintegrations\u002F_dir","docs\u002F5.integrations\u002F_dir",{"title":312,"path":313,"stem":314,"children":315},"FlowDSL Node Catalog","\u002Fdocs\u002Fnodes","docs\u002F5.nodes\u002Findex",[316,317,321,325,329,333,337,341,345,349,353,357,361,365,369,373,377,381,385,389,393,397,401,405,409,413,417,421,425,429,433,437,441,445,449,453,457,461,465,469,473,477,481,485,489,493,497,501,505,509,513,517,521,525,529,533,537,541,545,549,553,557,561,565,569,573,577,581,585,589,593,597,601,605,609,613,617,621,625,629,633,637,641,645,649,653,657,661,665,669,673,677,681,685,689,693,697,701,705,709,713,717,721,725,729,733,737,741,745,749,753,757,761,765,769,773,777,781,785,789,793,797,801,805,809,813,817,821,825,829,833,837,841,845,849,853,857,861,865,869,873,877,881,885,889],{"title":312,"path":313,"stem":314},{"title":318,"path":319,"stem":320,"order":57},"Node Catalog","\u002Fdocs\u002Fnodes\u002F_dir","docs\u002F5.nodes\u002F_dir",{"title":322,"path":323,"stem":324},"Record Alert","\u002Fdocs\u002Fnodes\u002Falerts_record","docs\u002F5.nodes\u002Falerts_record",{"title":326,"path":327,"stem":328},"Log to API Log","\u002Fdocs\u002Fnodes\u002Fapilog_record","docs\u002F5.nodes\u002Fapilog_record",{"title":330,"path":331,"stem":332},"ClickHouse Exec","\u002Fdocs\u002Fnodes\u002Fclickhouse_exec","docs\u002F5.nodes\u002Fclickhouse_exec",{"title":334,"path":335,"stem":336},"ClickHouse Insert","\u002Fdocs\u002Fnodes\u002Fclickhouse_insert","docs\u002F5.nodes\u002Fclickhouse_insert",{"title":338,"path":339,"stem":340},"ClickHouse Query","\u002Fdocs\u002Fnodes\u002Fclickhouse_query","docs\u002F5.nodes\u002Fclickhouse_query",{"title":342,"path":343,"stem":344},"Array Op","\u002Fdocs\u002Fnodes\u002Fcore_array-ops","docs\u002F5.nodes\u002Fcore_array-ops",{"title":346,"path":347,"stem":348},"Assert","\u002Fdocs\u002Fnodes\u002Fcore_assert","docs\u002F5.nodes\u002Fcore_assert",{"title":350,"path":351,"stem":352},"Audit Emit","\u002Fdocs\u002Fnodes\u002Fcore_audit-emit","docs\u002F5.nodes\u002Fcore_audit-emit",{"title":354,"path":355,"stem":356},"Catch","\u002Fdocs\u002Fnodes\u002Fcore_catch","docs\u002F5.nodes\u002Fcore_catch",{"title":358,"path":359,"stem":360},"DateTime","\u002Fdocs\u002Fnodes\u002Fcore_datetime","docs\u002F5.nodes\u002Fcore_datetime",{"title":362,"path":363,"stem":364},"Dead Letter","\u002Fdocs\u002Fnodes\u002Fcore_dead-letter","docs\u002F5.nodes\u002Fcore_dead-letter",{"title":366,"path":367,"stem":368},"Delay","\u002Fdocs\u002Fnodes\u002Fcore_delay","docs\u002F5.nodes\u002Fcore_delay",{"title":370,"path":371,"stem":372},"ForEach","\u002Fdocs\u002Fnodes\u002Fcore_foreach","docs\u002F5.nodes\u002Fcore_foreach",{"title":374,"path":375,"stem":376},"Idempotency Key","\u002Fdocs\u002Fnodes\u002Fcore_idempotency-key","docs\u002F5.nodes\u002Fcore_idempotency-key",{"title":378,"path":379,"stem":380},"If","\u002Fdocs\u002Fnodes\u002Fcore_if","docs\u002F5.nodes\u002Fcore_if",{"title":382,"path":383,"stem":384},"Inspect","\u002Fdocs\u002Fnodes\u002Fcore_inspect","docs\u002F5.nodes\u002Fcore_inspect",{"title":386,"path":387,"stem":388},"JSON Merge","\u002Fdocs\u002Fnodes\u002Fcore_json-merge","docs\u002F5.nodes\u002Fcore_json-merge",{"title":390,"path":391,"stem":392},"JSON Schema Validate","\u002Fdocs\u002Fnodes\u002Fcore_json-schema-validate","docs\u002F5.nodes\u002Fcore_json-schema-validate",{"title":394,"path":395,"stem":396},"JSONPath Extract","\u002Fdocs\u002Fnodes\u002Fcore_jsonpath-extract","docs\u002F5.nodes\u002Fcore_jsonpath-extract",{"title":398,"path":399,"stem":400},"Log","\u002Fdocs\u002Fnodes\u002Fcore_log","docs\u002F5.nodes\u002Fcore_log",{"title":402,"path":403,"stem":404},"Math","\u002Fdocs\u002Fnodes\u002Fcore_math","docs\u002F5.nodes\u002Fcore_math",{"title":406,"path":407,"stem":408},"Merge","\u002Fdocs\u002Fnodes\u002Fcore_merge","docs\u002F5.nodes\u002Fcore_merge",{"title":410,"path":411,"stem":412},"Metric Counter","\u002Fdocs\u002Fnodes\u002Fcore_metric-counter","docs\u002F5.nodes\u002Fcore_metric-counter",{"title":414,"path":415,"stem":416},"Metric Gauge","\u002Fdocs\u002Fnodes\u002Fcore_metric-gauge","docs\u002F5.nodes\u002Fcore_metric-gauge",{"title":418,"path":419,"stem":420},"Mock","\u002Fdocs\u002Fnodes\u002Fcore_mock","docs\u002F5.nodes\u002Fcore_mock",{"title":422,"path":423,"stem":424},"No-op","\u002Fdocs\u002Fnodes\u002Fcore_noop","docs\u002F5.nodes\u002Fcore_noop",{"title":426,"path":427,"stem":428},"Object Omit","\u002Fdocs\u002Fnodes\u002Fcore_object-omit","docs\u002F5.nodes\u002Fcore_object-omit",{"title":430,"path":431,"stem":432},"Object Pick","\u002Fdocs\u002Fnodes\u002Fcore_object-pick","docs\u002F5.nodes\u002Fcore_object-pick",{"title":434,"path":435,"stem":436},"Parallel Fan-Out","\u002Fdocs\u002Fnodes\u002Fcore_parallel","docs\u002F5.nodes\u002Fcore_parallel",{"title":438,"path":439,"stem":440},"Raise","\u002Fdocs\u002Fnodes\u002Fcore_raise","docs\u002F5.nodes\u002Fcore_raise",{"title":442,"path":443,"stem":444},"Rate Limit Check","\u002Fdocs\u002Fnodes\u002Fcore_rate-limit-check","docs\u002F5.nodes\u002Fcore_rate-limit-check",{"title":446,"path":447,"stem":448},"Regex Extract","\u002Fdocs\u002Fnodes\u002Fcore_regex-extract","docs\u002F5.nodes\u002Fcore_regex-extract",{"title":450,"path":451,"stem":452},"Require Fields","\u002Fdocs\u002Fnodes\u002Fcore_require-fields","docs\u002F5.nodes\u002Fcore_require-fields",{"title":454,"path":455,"stem":456},"Rethrow","\u002Fdocs\u002Fnodes\u002Fcore_rethrow","docs\u002F5.nodes\u002Fcore_rethrow",{"title":458,"path":459,"stem":460},"Return","\u002Fdocs\u002Fnodes\u002Fcore_return","docs\u002F5.nodes\u002Fcore_return",{"title":462,"path":463,"stem":464},"HMAC Signature Verify","\u002Fdocs\u002Fnodes\u002Fcore_signature-verify","docs\u002F5.nodes\u002Fcore_signature-verify",{"title":466,"path":467,"stem":468},"String Op","\u002Fdocs\u002Fnodes\u002Fcore_string-ops","docs\u002F5.nodes\u002Fcore_string-ops",{"title":470,"path":471,"stem":472},"Subflow Invoke","\u002Fdocs\u002Fnodes\u002Fcore_subflow-invoke","docs\u002F5.nodes\u002Fcore_subflow-invoke",{"title":474,"path":475,"stem":476},"Switch","\u002Fdocs\u002Fnodes\u002Fcore_switch","docs\u002F5.nodes\u002Fcore_switch",{"title":478,"path":479,"stem":480},"Template Render","\u002Fdocs\u002Fnodes\u002Fcore_template-render","docs\u002F5.nodes\u002Fcore_template-render",{"title":482,"path":483,"stem":484},"Throttle","\u002Fdocs\u002Fnodes\u002Fcore_throttle","docs\u002F5.nodes\u002Fcore_throttle",{"title":486,"path":487,"stem":488},"Timeout","\u002Fdocs\u002Fnodes\u002Fcore_timeout","docs\u002F5.nodes\u002Fcore_timeout",{"title":490,"path":491,"stem":492},"Type Cast","\u002Fdocs\u002Fnodes\u002Fcore_type-cast","docs\u002F5.nodes\u002Fcore_type-cast",{"title":494,"path":495,"stem":496},"Webhook Respond","\u002Fdocs\u002Fnodes\u002Fcore_webhook-respond","docs\u002F5.nodes\u002Fcore_webhook-respond",{"title":498,"path":499,"stem":500},"File Delete","\u002Fdocs\u002Fnodes\u002Ffilesys_delete","docs\u002F5.nodes\u002Ffilesys_delete",{"title":502,"path":503,"stem":504},"Directory List","\u002Fdocs\u002Fnodes\u002Ffilesys_list","docs\u002F5.nodes\u002Ffilesys_list",{"title":506,"path":507,"stem":508},"File Read","\u002Fdocs\u002Fnodes\u002Ffilesys_read","docs\u002F5.nodes\u002Ffilesys_read",{"title":510,"path":511,"stem":512},"File Stat","\u002Fdocs\u002Fnodes\u002Ffilesys_stat","docs\u002F5.nodes\u002Ffilesys_stat",{"title":514,"path":515,"stem":516},"File Write","\u002Fdocs\u002Fnodes\u002Ffilesys_write","docs\u002F5.nodes\u002Ffilesys_write",{"title":518,"path":519,"stem":520},"FTP Delete","\u002Fdocs\u002Fnodes\u002Fftp_delete","docs\u002F5.nodes\u002Fftp_delete",{"title":522,"path":523,"stem":524},"FTP Download","\u002Fdocs\u002Fnodes\u002Fftp_download","docs\u002F5.nodes\u002Fftp_download",{"title":526,"path":527,"stem":528},"FTP List","\u002Fdocs\u002Fnodes\u002Fftp_list","docs\u002F5.nodes\u002Fftp_list",{"title":530,"path":531,"stem":532},"FTP Upload","\u002Fdocs\u002Fnodes\u002Fftp_upload","docs\u002F5.nodes\u002Fftp_upload",{"title":534,"path":535,"stem":536},"HTTP DELETE","\u002Fdocs\u002Fnodes\u002Fhttp_delete","docs\u002F5.nodes\u002Fhttp_delete",{"title":538,"path":539,"stem":540},"HTTP GET","\u002Fdocs\u002Fnodes\u002Fhttp_get","docs\u002F5.nodes\u002Fhttp_get",{"title":542,"path":543,"stem":544},"HTTP POST","\u002Fdocs\u002Fnodes\u002Fhttp_post","docs\u002F5.nodes\u002Fhttp_post",{"title":546,"path":547,"stem":548},"HTTP PUT","\u002Fdocs\u002Fnodes\u002Fhttp_put","docs\u002F5.nodes\u002Fhttp_put",{"title":550,"path":551,"stem":552},"HTTP Request","\u002Fdocs\u002Fnodes\u002Fhttp_request","docs\u002F5.nodes\u002Fhttp_request",{"title":554,"path":555,"stem":556},"Fill Translations","\u002Fdocs\u002Fnodes\u002Fi18n_fill-translations","docs\u002F5.nodes\u002Fi18n_fill-translations",{"title":558,"path":559,"stem":560},"Resolve Locale","\u002Fdocs\u002Fnodes\u002Fi18n_resolve-locale","docs\u002F5.nodes\u002Fi18n_resolve-locale",{"title":562,"path":563,"stem":564},"Translate","\u002Fdocs\u002Fnodes\u002Fi18n_translate","docs\u002F5.nodes\u002Fi18n_translate",{"title":566,"path":567,"stem":568},"Mongo AGGREGATE","\u002Fdocs\u002Fnodes\u002Fmongoops_aggregate","docs\u002F5.nodes\u002Fmongoops_aggregate",{"title":570,"path":571,"stem":572},"Mongo DELETE","\u002Fdocs\u002Fnodes\u002Fmongoops_delete","docs\u002F5.nodes\u002Fmongoops_delete",{"title":574,"path":575,"stem":576},"Mongo FIND","\u002Fdocs\u002Fnodes\u002Fmongoops_find","docs\u002F5.nodes\u002Fmongoops_find",{"title":578,"path":579,"stem":580},"Mongo FIND ONE","\u002Fdocs\u002Fnodes\u002Fmongoops_find-one","docs\u002F5.nodes\u002Fmongoops_find-one",{"title":582,"path":583,"stem":584},"Mongo INSERT","\u002Fdocs\u002Fnodes\u002Fmongoops_insert","docs\u002F5.nodes\u002Fmongoops_insert",{"title":586,"path":587,"stem":588},"Mongo UPDATE","\u002Fdocs\u002Fnodes\u002Fmongoops_update","docs\u002F5.nodes\u002Fmongoops_update",{"title":590,"path":591,"stem":592},"Postgres COPY FROM","\u002Fdocs\u002Fnodes\u002Fpostgres_copy-from","docs\u002F5.nodes\u002Fpostgres_copy-from",{"title":594,"path":595,"stem":596},"Postgres Exec","\u002Fdocs\u002Fnodes\u002Fpostgres_exec","docs\u002F5.nodes\u002Fpostgres_exec",{"title":598,"path":599,"stem":600},"Postgres Query","\u002Fdocs\u002Fnodes\u002Fpostgres_query","docs\u002F5.nodes\u002Fpostgres_query",{"title":602,"path":603,"stem":604},"Postgres Transaction","\u002Fdocs\u002Fnodes\u002Fpostgres_transaction","docs\u002F5.nodes\u002Fpostgres_transaction",{"title":606,"path":607,"stem":608},"RabbitMQ Consume","\u002Fdocs\u002Fnodes\u002Frabbitmq_consume","docs\u002F5.nodes\u002Frabbitmq_consume",{"title":610,"path":611,"stem":612},"RabbitMQ Declare","\u002Fdocs\u002Fnodes\u002Frabbitmq_declare","docs\u002F5.nodes\u002Frabbitmq_declare",{"title":614,"path":615,"stem":616},"RabbitMQ Publish","\u002Fdocs\u002Fnodes\u002Frabbitmq_publish","docs\u002F5.nodes\u002Frabbitmq_publish",{"title":618,"path":619,"stem":620},"Auth Login","\u002Fdocs\u002Fnodes\u002Fredelay_auth-login","docs\u002F5.nodes\u002Fredelay_auth-login",{"title":622,"path":623,"stem":624},"Require Permission","\u002Fdocs\u002Fnodes\u002Fredelay_auth-require-permission","docs\u002F5.nodes\u002Fredelay_auth-require-permission",{"title":626,"path":627,"stem":628},"Validate Token","\u002Fdocs\u002Fnodes\u002Fredelay_auth-validate-token","docs\u002F5.nodes\u002Fredelay_auth-validate-token",{"title":630,"path":631,"stem":632},"Render Email Template","\u002Fdocs\u002Fnodes\u002Fredelay_email-render-template","docs\u002F5.nodes\u002Fredelay_email-render-template",{"title":634,"path":635,"stem":636},"Send Email","\u002Fdocs\u002Fnodes\u002Fredelay_email-send","docs\u002F5.nodes\u002Fredelay_email-send",{"title":638,"path":639,"stem":640},"Send Templated Email","\u002Fdocs\u002Fnodes\u002Fredelay_email-send-templated","docs\u002F5.nodes\u002Fredelay_email-send-templated",{"title":642,"path":643,"stem":644},"Event Source","\u002Fdocs\u002Fnodes\u002Fredelay_event-source","docs\u002F5.nodes\u002Fredelay_event-source",{"title":646,"path":647,"stem":648},"Create Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-create-group","docs\u002F5.nodes\u002Fredelay_groups-create-group",{"title":650,"path":651,"stem":652},"Delete Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-delete-group","docs\u002F5.nodes\u002Fredelay_groups-delete-group",{"title":654,"path":655,"stem":656},"Resolve Permissions","\u002Fdocs\u002Fnodes\u002Fredelay_groups-resolve-permissions","docs\u002F5.nodes\u002Fredelay_groups-resolve-permissions",{"title":658,"path":659,"stem":660},"Update Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-update-group","docs\u002F5.nodes\u002Fredelay_groups-update-group",{"title":662,"path":663,"stem":664},"HTTP Endpoint","\u002Fdocs\u002Fnodes\u002Fredelay_http-endpoint","docs\u002F5.nodes\u002Fredelay_http-endpoint",{"title":666,"path":667,"stem":668},"JSON Stream Source","\u002Fdocs\u002Fnodes\u002Fredelay_json-stream-source","docs\u002F5.nodes\u002Fredelay_json-stream-source",{"title":670,"path":671,"stem":672},"JSON → Event","\u002Fdocs\u002Fnodes\u002Fredelay_json-to-event","docs\u002F5.nodes\u002Fredelay_json-to-event",{"title":674,"path":675,"stem":676},"Kafka Produce","\u002Fdocs\u002Fnodes\u002Fredelay_kafka-produce","docs\u002F5.nodes\u002Fredelay_kafka-produce",{"title":678,"path":679,"stem":680},"Create Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-create","docs\u002F5.nodes\u002Fredelay_links-create",{"title":682,"path":683,"stem":684},"Delete Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-delete","docs\u002F5.nodes\u002Fredelay_links-delete",{"title":686,"path":687,"stem":688},"Resolve Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-resolve","docs\u002F5.nodes\u002Fredelay_links-resolve",{"title":690,"path":691,"stem":692},"LLM Chat","\u002Fdocs\u002Fnodes\u002Fredelay_llm-chat","docs\u002F5.nodes\u002Fredelay_llm-chat",{"title":694,"path":695,"stem":696},"LLM Embed","\u002Fdocs\u002Fnodes\u002Fredelay_llm-embed","docs\u002F5.nodes\u002Fredelay_llm-embed",{"title":698,"path":699,"stem":700},"LLM Guard","\u002Fdocs\u002Fnodes\u002Fredelay_llm-guard","docs\u002F5.nodes\u002Fredelay_llm-guard",{"title":702,"path":703,"stem":704},"LLM Tool Router","\u002Fdocs\u002Fnodes\u002Fredelay_llm-tool-router","docs\u002F5.nodes\u002Fredelay_llm-tool-router",{"title":706,"path":707,"stem":708},"NATS Publish","\u002Fdocs\u002Fnodes\u002Fredelay_nats-publish","docs\u002F5.nodes\u002Fredelay_nats-publish",{"title":710,"path":711,"stem":712},"Mark Notification Read","\u002Fdocs\u002Fnodes\u002Fredelay_notifications-mark-read","docs\u002F5.nodes\u002Fredelay_notifications-mark-read",{"title":714,"path":715,"stem":716},"Send Notification","\u002Fdocs\u002Fnodes\u002Fredelay_notifications-send","docs\u002F5.nodes\u002Fredelay_notifications-send",{"title":718,"path":719,"stem":720},"Redis Stream XADD","\u002Fdocs\u002Fnodes\u002Fredelay_redis-stream-publish","docs\u002F5.nodes\u002Fredelay_redis-stream-publish",{"title":722,"path":723,"stem":724},"S3 Copy Object","\u002Fdocs\u002Fnodes\u002Fredelay_s3-copy-object","docs\u002F5.nodes\u002Fredelay_s3-copy-object",{"title":726,"path":727,"stem":728},"S3 Delete Many","\u002Fdocs\u002Fnodes\u002Fredelay_s3-delete-many","docs\u002F5.nodes\u002Fredelay_s3-delete-many",{"title":730,"path":731,"stem":732},"S3 Head Object","\u002Fdocs\u002Fnodes\u002Fredelay_s3-head-object","docs\u002F5.nodes\u002Fredelay_s3-head-object",{"title":734,"path":735,"stem":736},"S3 List Objects","\u002Fdocs\u002Fnodes\u002Fredelay_s3-list-objects","docs\u002F5.nodes\u002Fredelay_s3-list-objects",{"title":738,"path":739,"stem":740},"Create Schedule","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-create-schedule","docs\u002F5.nodes\u002Fredelay_scheduler-create-schedule",{"title":742,"path":743,"stem":744},"Cron Trigger","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-cron-trigger","docs\u002F5.nodes\u002Fredelay_scheduler-cron-trigger",{"title":746,"path":747,"stem":748},"Delete Schedule","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-delete-schedule","docs\u002F5.nodes\u002Fredelay_scheduler-delete-schedule",{"title":750,"path":751,"stem":752},"Interval Trigger","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-interval-trigger","docs\u002F5.nodes\u002Fredelay_scheduler-interval-trigger",{"title":754,"path":755,"stem":756},"Search Query","\u002Fdocs\u002Fnodes\u002Fredelay_search-query","docs\u002F5.nodes\u002Fredelay_search-query",{"title":758,"path":759,"stem":760},"Search Upsert","\u002Fdocs\u002Fnodes\u002Fredelay_search-upsert","docs\u002F5.nodes\u002Fredelay_search-upsert",{"title":762,"path":763,"stem":764},"Delete Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-delete","docs\u002F5.nodes\u002Fredelay_settings-delete",{"title":766,"path":767,"stem":768},"Get Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-get","docs\u002F5.nodes\u002Fredelay_settings-get",{"title":770,"path":771,"stem":772},"Set Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-set","docs\u002F5.nodes\u002Fredelay_settings-set",{"title":774,"path":775,"stem":776},"Delete File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-delete","docs\u002F5.nodes\u002Fredelay_storage-delete",{"title":778,"path":779,"stem":780},"Download File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-download","docs\u002F5.nodes\u002Fredelay_storage-download",{"title":782,"path":783,"stem":784},"Generate Presigned URL","\u002Fdocs\u002Fnodes\u002Fredelay_storage-presign-url","docs\u002F5.nodes\u002Fredelay_storage-presign-url",{"title":786,"path":787,"stem":788},"Upload File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-upload","docs\u002F5.nodes\u002Fredelay_storage-upload",{"title":790,"path":791,"stem":792},"Subworkflow","\u002Fdocs\u002Fnodes\u002Fredelay_subworkflow","docs\u002F5.nodes\u002Fredelay_subworkflow",{"title":794,"path":795,"stem":796},"Activate User","\u002Fdocs\u002Fnodes\u002Fredelay_users-activate","docs\u002F5.nodes\u002Fredelay_users-activate",{"title":798,"path":799,"stem":800},"Create Pending User","\u002Fdocs\u002Fnodes\u002Fredelay_users-create-pending","docs\u002F5.nodes\u002Fredelay_users-create-pending",{"title":802,"path":803,"stem":804},"Create User","\u002Fdocs\u002Fnodes\u002Fredelay_users-create-user","docs\u002F5.nodes\u002Fredelay_users-create-user",{"title":806,"path":807,"stem":808},"Delete User","\u002Fdocs\u002Fnodes\u002Fredelay_users-delete-user","docs\u002F5.nodes\u002Fredelay_users-delete-user",{"title":810,"path":811,"stem":812},"Find User By Email","\u002Fdocs\u002Fnodes\u002Fredelay_users-find-by-email","docs\u002F5.nodes\u002Fredelay_users-find-by-email",{"title":814,"path":815,"stem":816},"Get User","\u002Fdocs\u002Fnodes\u002Fredelay_users-get-user","docs\u002F5.nodes\u002Fredelay_users-get-user",{"title":818,"path":819,"stem":820},"List Users","\u002Fdocs\u002Fnodes\u002Fredelay_users-list-users","docs\u002F5.nodes\u002Fredelay_users-list-users",{"title":822,"path":823,"stem":824},"Update User","\u002Fdocs\u002Fnodes\u002Fredelay_users-update-user","docs\u002F5.nodes\u002Fredelay_users-update-user",{"title":826,"path":827,"stem":828},"Request Email Verification (legacy)","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request","docs\u002F5.nodes\u002Fredelay_verification-request",{"title":830,"path":831,"stem":832},"Request Email Verification","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request-email","docs\u002F5.nodes\u002Fredelay_verification-request-email",{"title":834,"path":835,"stem":836},"Request SMS Verification","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request-sms","docs\u002F5.nodes\u002Fredelay_verification-request-sms",{"title":838,"path":839,"stem":840},"Verify Token","\u002Fdocs\u002Fnodes\u002Fredelay_verification-verify","docs\u002F5.nodes\u002Fredelay_verification-verify",{"title":842,"path":843,"stem":844},"Redis DEL","\u002Fdocs\u002Fnodes\u002Fredisops_del","docs\u002F5.nodes\u002Fredisops_del",{"title":846,"path":847,"stem":848},"Redis EXPIRE","\u002Fdocs\u002Fnodes\u002Fredisops_expire","docs\u002F5.nodes\u002Fredisops_expire",{"title":850,"path":851,"stem":852},"Redis GET","\u002Fdocs\u002Fnodes\u002Fredisops_get","docs\u002F5.nodes\u002Fredisops_get",{"title":854,"path":855,"stem":856},"Redis HGET","\u002Fdocs\u002Fnodes\u002Fredisops_hget","docs\u002F5.nodes\u002Fredisops_hget",{"title":858,"path":859,"stem":860},"Redis HSET","\u002Fdocs\u002Fnodes\u002Fredisops_hset","docs\u002F5.nodes\u002Fredisops_hset",{"title":862,"path":863,"stem":864},"Redis INCR","\u002Fdocs\u002Fnodes\u002Fredisops_incr","docs\u002F5.nodes\u002Fredisops_incr",{"title":866,"path":867,"stem":868},"Redis LPOP","\u002Fdocs\u002Fnodes\u002Fredisops_lpop","docs\u002F5.nodes\u002Fredisops_lpop",{"title":870,"path":871,"stem":872},"Redis LPUSH","\u002Fdocs\u002Fnodes\u002Fredisops_lpush","docs\u002F5.nodes\u002Fredisops_lpush",{"title":874,"path":875,"stem":876},"Redis PUBLISH","\u002Fdocs\u002Fnodes\u002Fredisops_publish","docs\u002F5.nodes\u002Fredisops_publish",{"title":878,"path":879,"stem":880},"Redis SET","\u002Fdocs\u002Fnodes\u002Fredisops_set","docs\u002F5.nodes\u002Fredisops_set",{"title":882,"path":883,"stem":884},"SFTP Download","\u002Fdocs\u002Fnodes\u002Fsftp_download","docs\u002F5.nodes\u002Fsftp_download",{"title":886,"path":887,"stem":888},"SFTP Upload","\u002Fdocs\u002Fnodes\u002Fsftp_upload","docs\u002F5.nodes\u002Fsftp_upload",{"title":890,"path":891,"stem":892},"Send SMS","\u002Fdocs\u002Fnodes\u002Fsms_send","docs\u002F5.nodes\u002Fsms_send",{"title":894,"path":895,"stem":896,"children":897,"page":62},"Rfcs","\u002Fdocs\u002Frfcs","docs\u002F6.rfcs",[898],{"title":899,"path":900,"stem":901},"RFC 0001 — Worker Assignment for Flow Deployments","\u002Fdocs\u002Frfcs\u002F0001-worker-assignment","docs\u002F6.rfcs\u002F0001-worker-assignment",{"title":903,"path":904,"stem":905,"children":906,"page":62},"Admin","\u002Fdocs\u002Fadmin","docs\u002F7.admin",[907,912,917,922,927,932,937,941,946],{"title":5,"path":908,"stem":909,"order":910,"icon":911},"\u002Fdocs\u002Fadmin\u002Foverview","docs\u002F7.admin\u002F00.overview",0,"i-lucide-compass",{"title":913,"path":914,"stem":915,"order":10,"icon":916},"Getting started","\u002Fdocs\u002Fadmin\u002Fgetting-started","docs\u002F7.admin\u002F01.getting-started","i-lucide-play",{"title":918,"path":919,"stem":920,"order":16,"icon":921},"Layered architecture","\u002Fdocs\u002Fadmin\u002Flayered-architecture","docs\u002F7.admin\u002F02.layered-architecture","i-lucide-layers",{"title":923,"path":924,"stem":925,"order":22,"icon":926},"Building a custom admin project","\u002Fdocs\u002Fadmin\u002Fbuilding-a-custom-admin-project","docs\u002F7.admin\u002F03.building-a-custom-admin-project","i-lucide-folder-plus",{"title":928,"path":929,"stem":930,"order":51,"icon":931},"Building admin modules","\u002Fdocs\u002Fadmin\u002Fbuilding-admin-modules","docs\u002F7.admin\u002F04.building-admin-modules","i-lucide-package-plus",{"title":933,"path":934,"stem":935,"order":57,"icon":936},"Base module reference","\u002Fdocs\u002Fadmin\u002Freference-base-modules","docs\u002F7.admin\u002F05.reference-base-modules","i-lucide-boxes",{"title":938,"path":939,"stem":940,"order":102,"icon":17},"Deployment","\u002Fdocs\u002Fadmin\u002Fdeployment","docs\u002F7.admin\u002F06.deployment",{"title":942,"path":943,"stem":944,"order":108,"icon":945},"Consuming the base layer (versioned)","\u002Fdocs\u002Fadmin\u002Fconsuming-the-base-layer","docs\u002F7.admin\u002F07.consuming-the-base-layer","i-lucide-package",{"title":947,"path":948,"stem":949,"order":108},"Admin UI","\u002Fdocs\u002Fadmin\u002F_dir","docs\u002F7.admin\u002F_dir",{"title":951,"path":952,"stem":953,"children":954,"page":62},"Services","\u002Fdocs\u002Fservices","docs\u002F8.services",[955,960],{"title":956,"path":957,"stem":958,"order":10,"icon":959},"Custom development & support services","\u002Fdocs\u002Fservices\u002Fcustom-development","docs\u002F8.services\u002F1.custom-development","i-lucide-briefcase",{"title":951,"path":961,"stem":962,"icon":959,"order":963},"\u002Fdocs\u002Fservices\u002F_dir","docs\u002F8.services\u002F_dir",80,{"title":965,"path":966,"stem":967,"order":910},"Dir","\u002Fdocs\u002F_dir","docs\u002F_dir",{"id":969,"title":82,"body":970,"description":4716,"extension":4717,"links":4718,"meta":4719,"navigation":4720,"path":83,"seo":4721,"stem":84,"__hash__":4722},"docs\u002Fdocs\u002F3.guides\u002F2.creating-go-module.md",{"type":971,"value":972,"toc":4684},"minimark",[973,977,981,1069,1074,1089,1097,1135,1140,1387,1409,1420,1439,1445,1475,1481,1490,1570,1580,1586,1593,1639,1645,1655,1827,1833,1836,1854,2080,2084,2094,2131,2135,2138,2303,2307,2355,2370,2373,2379,2398,2404,2462,2472,2488,2494,2503,2624,2631,2644,2650,2655,2678,2687,2761,2776,2989,3005,3142,3155,3161,3166,3208,3215,3246,3252,3261,3375,3385,3463,3466,3516,3522,3529,3672,3687,3696,4368,4373,4419,4426,4438,4442,4571,4575,4598,4636,4639,4673,4680],[974,975,82],"h1",{"id":976},"creating-a-go-module",[978,979,980],"p",{},"This guide walks through creating a new module for the Redelay Go framework.",[982,983,984,996,1036],"callout",{"icon":36},[978,985,986,990,991,995],{},[987,988,989],"strong",{},"Quick start:"," If you have a ",[992,993,994],"code",{},"module.yaml",", you can scaffold the entire module in one command:",[997,998,1003],"pre",{"className":999,"code":1000,"language":1001,"meta":1002,"style":1002},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","redelayctl validate-module module.yaml  # check for errors first\nredelayctl scaffold module.yaml .\u002Fmodules\u002Fmymodule\u002F\n","bash","",[992,1004,1005,1024],{"__ignoreMap":1002},[1006,1007,1009,1013,1017,1020],"span",{"class":1008,"line":10},"line",[1006,1010,1012],{"class":1011},"sBMFI","redelayctl",[1006,1014,1016],{"class":1015},"sfazB"," validate-module",[1006,1018,1019],{"class":1015}," module.yaml",[1006,1021,1023],{"class":1022},"sHwdD","  # check for errors first\n",[1006,1025,1026,1028,1031,1033],{"class":1008,"line":16},[1006,1027,1012],{"class":1011},[1006,1029,1030],{"class":1015}," scaffold",[1006,1032,1019],{"class":1015},[1006,1034,1035],{"class":1015}," .\u002Fmodules\u002Fmymodule\u002F\n",[978,1037,1038,1039,1042,1043,1046,1047,1050,1051,1054,1055,1057,1058,1060,1061,1064,1065,1068],{},"This generates ",[992,1040,1041],{},"module.go",", plus ",[992,1044,1045],{},"routes.go"," when the YAML declares routes and\n",[992,1048,1049],{},"handlers.go"," when it declares CRUD operations. That split predates the layout\nconvention below — fold ",[992,1052,1053],{},"Routes()"," into ",[992,1056,1041],{}," and rename ",[992,1059,1049],{}," to\n",[992,1062,1063],{},"handler.go"," as you flesh the module out.\nSee ",[1066,1067,164],"a",{"href":165}," for the full tooling pipeline.",[1070,1071,1073],"h2",{"id":1072},"directory-structure","Directory Structure",[978,1075,1076,1077,1080,1081,1084,1085,1088],{},"Every module lives under ",[992,1078,1079],{},"modules\u002F\u003Cname>\u002F"," (or ",[992,1082,1083],{},"\u003Cname>\u002F"," in ",[992,1086,1087],{},"go-modules\u002F","). The\ncanonical layout splits each concern into its own file. Only create files that\nhave content — empty stubs are noise.",[997,1090,1095],{"className":1091,"code":1093,"language":1094},[1092],"language-text","mymodule\u002F\n├── module.go     # factory + Module struct + lifecycle + Routes()\n├── ir.go         # \u002F\u002Fgo:embed module.yaml\n├── config.go     # Config struct + DefaultConfig() (env vars)\n├── schemas.go    # HTTP request\u002Fresponse DTOs\n├── model.go      # domain types persisted to DB\n├── service.go    # business logic\n├── crud.go       # Mongo \u002F ClickHouse persistence (Store)\n├── handler.go    # HTTP handlers (the API layer)\n├── consumers.go  # event subscriptions (Consumers() + handler funcs)\n├── events.go     # typed.EventDefinition vars + payload structs published here\n├── lookup.go     # cross-module adapter (optional)\n├── module.yaml   # module manifest (events, packets, nodes, settings)\n├── flowdsl\u002F      # FlowDSL nodes companion module (optional)\n└── admin\u002F        # admin-only submodule (optional)\n","text",[992,1096,1093],{"__ignoreMap":1002},[982,1098,1099,1108],{"icon":11},[978,1100,1101,1104,1105,1107],{},[987,1102,1103],{},"Why split this way?"," ",[992,1106,1041],{}," becomes a tiny \"wiring\" file (factory + struct",[1109,1110,1111],"ul",{},[1112,1113,1114,1115,1118,1119,1122,1123,1126,1127,1130,1131,1134],"li",{},"lifecycle + Routes()). Everything else follows the single-responsibility\nprinciple: HTTP shape lives in ",[992,1116,1117],{},"schemas.go",", persistence in ",[992,1120,1121],{},"crud.go",", business\nlogic in ",[992,1124,1125],{},"service.go",", event subscription in ",[992,1128,1129],{},"consumers.go",", event publishing in\n",[992,1132,1133],{},"events.go",". New contributors find what they need without grepping.",[978,1136,1137],{},[987,1138,1139],{},"File responsibilities:",[1141,1142,1143,1159],"table",{},[1144,1145,1146],"thead",{},[1147,1148,1149,1153,1156],"tr",{},[1150,1151,1152],"th",{},"File",[1150,1154,1155],{},"Contents",[1150,1157,1158],{},"Notes",[1160,1161,1162,1195,1217,1236,1255,1272,1291,1308,1322,1340,1359,1375],"tbody",{},[1147,1163,1164,1169,1192],{},[1165,1166,1167],"td",{},[992,1168,1041],{},[1165,1170,1171,1174,1175,1178,1179,1182,1183,1186,1187,1186,1189],{},[992,1172,1173],{},"init()"," factory, ",[992,1176,1177],{},"Module"," struct, ",[992,1180,1181],{},"Startup","\u002F",[992,1184,1185],{},"Shutdown",", ",[992,1188,1053],{},[992,1190,1191],{},"Configure()",[1165,1193,1194],{},"Keep this file thin — wiring only",[1147,1196,1197,1202,1211],{},[1165,1198,1199],{},[992,1200,1201],{},"ir.go",[1165,1203,1204,1207,1208],{},[992,1205,1206],{},"\u002F\u002Fgo:embed module.yaml"," + ",[992,1209,1210],{},"var moduleYAML []byte",[1165,1212,1213,1214],{},"One-liner — separate so other files don't need ",[992,1215,1216],{},"embed",[1147,1218,1219,1224,1233],{},[1165,1220,1221],{},[992,1222,1223],{},"config.go",[1165,1225,1226,1178,1229,1232],{},[992,1227,1228],{},"Config",[992,1230,1231],{},"DefaultConfig()"," reads all env vars",[1165,1234,1235],{},"Single source of truth for env-var names",[1147,1237,1238,1242,1252],{},[1165,1239,1240],{},[992,1241,1117],{},[1165,1243,1244,1245,1186,1248,1251],{},"Request\u002Fresponse DTOs (e.g. ",[992,1246,1247],{},"UserCreateInput",[992,1249,1250],{},"UserResponse",")",[1165,1253,1254],{},"Public API surface; visible in OpenAPI spec",[1147,1256,1257,1262,1269],{},[1165,1258,1259],{},[992,1260,1261],{},"model.go",[1165,1263,1264,1265,1268],{},"DB-persisted types with ",[992,1266,1267],{},"bson"," tags",[1165,1270,1271],{},"Internal; never returned directly from handlers",[1147,1273,1274,1278,1284],{},[1165,1275,1276],{},[992,1277,1125],{},[1165,1279,1280,1281],{},"Business logic methods on ",[992,1282,1283],{},"*Service",[1165,1285,1286,1287,1290],{},"Calls into ",[992,1288,1289],{},"Store",", transforms model→response",[1147,1292,1293,1297,1302],{},[1165,1294,1295],{},[992,1296,1121],{},[1165,1298,1299,1301],{},[992,1300,1289],{}," struct + Mongo\u002FCH persistence",[1165,1303,1304,1305],{},"Single place for DB queries; mockable via ",[992,1306,1307],{},"StoreIface",[1147,1309,1310,1314,1319],{},[1165,1311,1312],{},[992,1313,1063],{},[1165,1315,1316],{},[992,1317,1318],{},"func (m *Module) handleX(w, r)",[1165,1320,1321],{},"HTTP-only concerns: parse body → service → write JSON",[1147,1323,1324,1328,1337],{},[1165,1325,1326],{},[992,1327,1129],{},[1165,1329,1330,1333,1334],{},[992,1331,1332],{},"Consumers()"," + handler funcs that read ",[992,1335,1336],{},"transport.EventMessage",[1165,1338,1339],{},"Each handler unmarshals payload, calls service",[1147,1341,1342,1346,1356],{},[1165,1343,1344],{},[992,1345,1133],{},[1165,1347,1348,1351,1352,1355],{},[992,1349,1350],{},"typed.EventDefinition"," vars + ",[992,1353,1354],{},"publishX()"," helpers + payload structs",[1165,1357,1358],{},"All \"this module publishes…\" lives here",[1147,1360,1361,1366,1372],{},[1165,1362,1363],{},[992,1364,1365],{},"lookup.go",[1165,1367,1368,1369,1251],{},"Adapters consumed by other modules (e.g. ",[992,1370,1371],{},"users.LookupProvider",[1165,1373,1374],{},"Optional; only when another module discovers via type assertion",[1147,1376,1377,1381,1384],{},[1165,1378,1379],{},[992,1380,994],{},[1165,1382,1383],{},"Manifest read at build\u002Fspec time",[1165,1385,1386],{},"Drives modspec browser, settings UI, AsyncAPI",[978,1388,1389,1390,1392,1393,1395,1396,1398,1399,1401,1402,1207,1404,1207,1406,1408],{},"Not every file is required. A pure-event worker has no ",[992,1391,1063],{}," or\n",[992,1394,1117],{},". A read-only adapter has no ",[992,1397,1121],{}," or ",[992,1400,1133],{},". Start with\n",[992,1403,1041],{},[992,1405,1201],{},[992,1407,994],{},"; add files as the module grows.",[1410,1411,1413,1414,1186,1417,1251],"h3",{"id":1412},"submodules-flowdsl-admin","Submodules (",[992,1415,1416],{},"flowdsl\u002F",[992,1418,1419],{},"admin\u002F",[978,1421,1422,1424,1425,1427,1428,1431,1432,1434,1435,1438],{},[992,1423,1416],{}," and ",[992,1426,1419],{}," subdirectories are ",[987,1429,1430],{},"independent modules"," — each has\nits own factory, ",[992,1433,994],{},", and lifecycle. They follow the ",[987,1436,1437],{},"same file\nsplit"," as the parent module:",[997,1440,1443],{"className":1441,"code":1442,"language":1094},[1092],"mymodule\u002F\n├── module.go            # parent module\n├── …\n├── flowdsl\u002F\n│   ├── module.go        # FlowDSL nodes companion module\n│   ├── ir.go\n│   └── module.yaml\n└── admin\u002F\n    ├── module.go        # admin routes mounted under \u002Fadmin\n    ├── ir.go\n    ├── schemas.go\n    ├── handler.go\n    └── module.yaml\n",[992,1444,1442],{"__ignoreMap":1002},[978,1446,1447,1448,1450,1451,1453,1454,1207,1456,1458,1459,1461,1462,1465,1466,1470,1471,1474],{},"A bare ",[992,1449,1416],{}," that only registers nodes typically needs only ",[992,1452,1041],{}," +\n",[992,1455,1201],{},[992,1457,994],{},". An ",[992,1460,1419],{}," with several CRUD endpoints follows the\nfull canonical split. ",[987,1463,1464],{},"Do not invent empty files"," — the rule is\n",[1467,1468,1469],"em",{},"one concern per file",", not ",[1467,1472,1473],{},"every concern always present",".",[1070,1476,1478,1479],{"id":1477},"step-1-create-configgo","Step 1: Create ",[992,1480,1223],{},[978,1482,1483,1484,1486,1487,1489],{},"Define a ",[992,1485,1228],{}," struct and a ",[992,1488,1231],{}," function that reads environment variables with a module-specific prefix.",[997,1491,1495],{"className":1492,"code":1493,"language":1494,"meta":1002,"style":1002},"language-go shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","package mymodule\n\nimport \"github.com\u002Fredelay\u002Fgo-framework\u002Fconfig\"\n\ntype Config struct {\n    Collection string `json:\"collection\" yaml:\"collection\"`\n    SomeOption int    `json:\"some_option\" yaml:\"some_option\"`\n}\n\nfunc DefaultConfig() *Config {\n    return &Config{\n        Collection: config.GetEnv(\"MYMODULE_COLLECTION\", \"my_items\"),\n        SomeOption: config.GetInt(\"MYMODULE_SOME_OPTION\", 42),\n    }\n}\n","go",[992,1496,1497,1502,1508,1513,1517,1522,1527,1532,1537,1541,1546,1551,1556,1561,1566],{"__ignoreMap":1002},[1006,1498,1499],{"class":1008,"line":10},[1006,1500,1501],{},"package mymodule\n",[1006,1503,1504],{"class":1008,"line":16},[1006,1505,1507],{"emptyLinePlaceholder":1506},true,"\n",[1006,1509,1510],{"class":1008,"line":22},[1006,1511,1512],{},"import \"github.com\u002Fredelay\u002Fgo-framework\u002Fconfig\"\n",[1006,1514,1515],{"class":1008,"line":51},[1006,1516,1507],{"emptyLinePlaceholder":1506},[1006,1518,1519],{"class":1008,"line":57},[1006,1520,1521],{},"type Config struct {\n",[1006,1523,1524],{"class":1008,"line":102},[1006,1525,1526],{},"    Collection string `json:\"collection\" yaml:\"collection\"`\n",[1006,1528,1529],{"class":1008,"line":108},[1006,1530,1531],{},"    SomeOption int    `json:\"some_option\" yaml:\"some_option\"`\n",[1006,1533,1534],{"class":1008,"line":114},[1006,1535,1536],{},"}\n",[1006,1538,1539],{"class":1008,"line":120},[1006,1540,1507],{"emptyLinePlaceholder":1506},[1006,1542,1543],{"class":1008,"line":181},[1006,1544,1545],{},"func DefaultConfig() *Config {\n",[1006,1547,1548],{"class":1008,"line":186},[1006,1549,1550],{},"    return &Config{\n",[1006,1552,1553],{"class":1008,"line":191},[1006,1554,1555],{},"        Collection: config.GetEnv(\"MYMODULE_COLLECTION\", \"my_items\"),\n",[1006,1557,1558],{"class":1008,"line":197},[1006,1559,1560],{},"        SomeOption: config.GetInt(\"MYMODULE_SOME_OPTION\", 42),\n",[1006,1562,1563],{"class":1008,"line":203},[1006,1564,1565],{},"    }\n",[1006,1567,1568],{"class":1008,"line":214},[1006,1569,1536],{},[978,1571,1572,1575,1576,1579],{},[987,1573,1574],{},"Convention",": Use the ",[992,1577,1578],{},"\u003CMODULE_NAME>_"," prefix for all environment variables.",[1070,1581,1583,1584],{"id":1582},"step-2-create-modelgo","Step 2: Create ",[992,1585,1261],{},[978,1587,1588,1589,1592],{},"Define MongoDB document structs. Embed ",[992,1590,1591],{},"crud.BaseModel"," for automatic ID, timestamps, and soft-delete support.",[997,1594,1596],{"className":1492,"code":1595,"language":1494,"meta":1002,"style":1002},"package mymodule\n\nimport \"github.com\u002Fredelay\u002Fgo-framework\u002Fcrud\"\n\ntype Item struct {\n    crud.BaseModel `bson:\",inline\"`\n    Name           string `bson:\"name\" json:\"name\"`\n    Description    string `bson:\"description,omitempty\" json:\"description,omitempty\"`\n}\n",[992,1597,1598,1602,1606,1611,1615,1620,1625,1630,1635],{"__ignoreMap":1002},[1006,1599,1600],{"class":1008,"line":10},[1006,1601,1501],{},[1006,1603,1604],{"class":1008,"line":16},[1006,1605,1507],{"emptyLinePlaceholder":1506},[1006,1607,1608],{"class":1008,"line":22},[1006,1609,1610],{},"import \"github.com\u002Fredelay\u002Fgo-framework\u002Fcrud\"\n",[1006,1612,1613],{"class":1008,"line":51},[1006,1614,1507],{"emptyLinePlaceholder":1506},[1006,1616,1617],{"class":1008,"line":57},[1006,1618,1619],{},"type Item struct {\n",[1006,1621,1622],{"class":1008,"line":102},[1006,1623,1624],{},"    crud.BaseModel `bson:\",inline\"`\n",[1006,1626,1627],{"class":1008,"line":108},[1006,1628,1629],{},"    Name           string `bson:\"name\" json:\"name\"`\n",[1006,1631,1632],{"class":1008,"line":114},[1006,1633,1634],{},"    Description    string `bson:\"description,omitempty\" json:\"description,omitempty\"`\n",[1006,1636,1637],{"class":1008,"line":120},[1006,1638,1536],{},[1070,1640,1642,1643],{"id":1641},"step-3-create-servicego","Step 3: Create ",[992,1644,1125],{},[978,1646,1647,1648,1651,1652,1474],{},"Encapsulate all business logic in a ",[992,1649,1650],{},"Service"," struct backed by ",[992,1653,1654],{},"crud.MongoCRUD[T]",[997,1656,1658],{"className":1492,"code":1657,"language":1494,"meta":1002,"style":1002},"package mymodule\n\nimport (\n    \"context\"\n\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fcrud\"\n    \"go.mongodb.org\u002Fmongo-driver\u002Fbson\"\n    \"go.mongodb.org\u002Fmongo-driver\u002Fmongo\"\n    \"go.uber.org\u002Fzap\"\n)\n\ntype Service struct {\n    cfg    *Config\n    crud   *crud.MongoCRUD[*Item]\n    logger *zap.Logger\n}\n\nfunc NewService(cfg *Config, col *mongo.Collection, logger *zap.Logger) *Service {\n    return &Service{\n        cfg:    cfg,\n        crud:   crud.NewMongoCRUD[*Item](col),\n        logger: logger.Named(\"mymodule\"),\n    }\n}\n\nfunc (s *Service) Create(ctx context.Context, name string) (*Item, error) {\n    return s.crud.Create(ctx, &Item{Name: name})\n}\n\nfunc (s *Service) EnsureIndexes(ctx context.Context) error {\n    return s.crud.EnsureIndexes(ctx,\n        mongo.IndexModel{Keys: bson.D{{Key: \"name\", Value: 1}}},\n    )\n}\n",[992,1659,1660,1664,1668,1673,1678,1682,1687,1692,1697,1702,1707,1711,1716,1721,1726,1731,1735,1739,1744,1749,1754,1759,1764,1769,1774,1778,1783,1788,1793,1798,1804,1810,1816,1822],{"__ignoreMap":1002},[1006,1661,1662],{"class":1008,"line":10},[1006,1663,1501],{},[1006,1665,1666],{"class":1008,"line":16},[1006,1667,1507],{"emptyLinePlaceholder":1506},[1006,1669,1670],{"class":1008,"line":22},[1006,1671,1672],{},"import (\n",[1006,1674,1675],{"class":1008,"line":51},[1006,1676,1677],{},"    \"context\"\n",[1006,1679,1680],{"class":1008,"line":57},[1006,1681,1507],{"emptyLinePlaceholder":1506},[1006,1683,1684],{"class":1008,"line":102},[1006,1685,1686],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fcrud\"\n",[1006,1688,1689],{"class":1008,"line":108},[1006,1690,1691],{},"    \"go.mongodb.org\u002Fmongo-driver\u002Fbson\"\n",[1006,1693,1694],{"class":1008,"line":114},[1006,1695,1696],{},"    \"go.mongodb.org\u002Fmongo-driver\u002Fmongo\"\n",[1006,1698,1699],{"class":1008,"line":120},[1006,1700,1701],{},"    \"go.uber.org\u002Fzap\"\n",[1006,1703,1704],{"class":1008,"line":181},[1006,1705,1706],{},")\n",[1006,1708,1709],{"class":1008,"line":186},[1006,1710,1507],{"emptyLinePlaceholder":1506},[1006,1712,1713],{"class":1008,"line":191},[1006,1714,1715],{},"type Service struct {\n",[1006,1717,1718],{"class":1008,"line":197},[1006,1719,1720],{},"    cfg    *Config\n",[1006,1722,1723],{"class":1008,"line":203},[1006,1724,1725],{},"    crud   *crud.MongoCRUD[*Item]\n",[1006,1727,1728],{"class":1008,"line":214},[1006,1729,1730],{},"    logger *zap.Logger\n",[1006,1732,1733],{"class":1008,"line":223},[1006,1734,1536],{},[1006,1736,1737],{"class":1008,"line":229},[1006,1738,1507],{"emptyLinePlaceholder":1506},[1006,1740,1741],{"class":1008,"line":234},[1006,1742,1743],{},"func NewService(cfg *Config, col *mongo.Collection, logger *zap.Logger) *Service {\n",[1006,1745,1746],{"class":1008,"line":240},[1006,1747,1748],{},"    return &Service{\n",[1006,1750,1751],{"class":1008,"line":246},[1006,1752,1753],{},"        cfg:    cfg,\n",[1006,1755,1756],{"class":1008,"line":251},[1006,1757,1758],{},"        crud:   crud.NewMongoCRUD[*Item](col),\n",[1006,1760,1761],{"class":1008,"line":257},[1006,1762,1763],{},"        logger: logger.Named(\"mymodule\"),\n",[1006,1765,1767],{"class":1008,"line":1766},23,[1006,1768,1565],{},[1006,1770,1772],{"class":1008,"line":1771},24,[1006,1773,1536],{},[1006,1775,1776],{"class":1008,"line":271},[1006,1777,1507],{"emptyLinePlaceholder":1506},[1006,1779,1780],{"class":1008,"line":277},[1006,1781,1782],{},"func (s *Service) Create(ctx context.Context, name string) (*Item, error) {\n",[1006,1784,1785],{"class":1008,"line":282},[1006,1786,1787],{},"    return s.crud.Create(ctx, &Item{Name: name})\n",[1006,1789,1791],{"class":1008,"line":1790},28,[1006,1792,1536],{},[1006,1794,1796],{"class":1008,"line":1795},29,[1006,1797,1507],{"emptyLinePlaceholder":1506},[1006,1799,1801],{"class":1008,"line":1800},30,[1006,1802,1803],{},"func (s *Service) EnsureIndexes(ctx context.Context) error {\n",[1006,1805,1807],{"class":1008,"line":1806},31,[1006,1808,1809],{},"    return s.crud.EnsureIndexes(ctx,\n",[1006,1811,1813],{"class":1008,"line":1812},32,[1006,1814,1815],{},"        mongo.IndexModel{Keys: bson.D{{Key: \"name\", Value: 1}}},\n",[1006,1817,1819],{"class":1008,"line":1818},33,[1006,1820,1821],{},"    )\n",[1006,1823,1825],{"class":1008,"line":1824},34,[1006,1826,1536],{},[1070,1828,1830,1831],{"id":1829},"step-4-create-modulego","Step 4: Create ",[992,1832,1041],{},[978,1834,1835],{},"This is the most important file. It:",[1837,1838,1839,1848],"ol",{},[1112,1840,1841,1842,1844,1845],{},"Defines the ",[992,1843,1177],{}," struct implementing ",[992,1846,1847],{},"modules.Module",[1112,1849,1850,1851,1853],{},"Registers via ",[992,1852,1173],{}," for autodiscovery",[997,1855,1857],{"className":1492,"code":1856,"language":1494,"meta":1002,"style":1002},"package mymodule\n\nimport (\n    \"context\"\n\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\"\n    \"go.mongodb.org\u002Fmongo-driver\u002Fmongo\"\n    \"go.uber.org\u002Fzap\"\n)\n\nfunc init() {\n    modules.RegisterFactory(\"mymodule\", func(deps modules.ModuleDeps) (modules.Module, error) {\n        cfg := DefaultConfig()\n        return NewModule(deps.DB, cfg, deps.Logger), nil\n    })\n}\n\ntype Module struct {\n    Service *Service\n    db      *mongo.Database\n    cfg     *Config\n    logger  *zap.Logger\n}\n\nfunc NewModule(db *mongo.Database, cfg *Config, logger *zap.Logger) *Module {\n    return &Module{db: db, cfg: cfg, logger: logger}\n}\n\nfunc (m *Module) Manifest() *modules.Manifest {\n    return &modules.Manifest{\n        Name:        \"mymodule\",\n        Description: \"My custom module\",\n        Version:     \"1.0.0\",\n        Provides:    []string{\"mymodule\"},\n    }\n}\n\nfunc (m *Module) Startup(ctx context.Context) error {\n    col := m.db.Collection(m.cfg.Collection)\n    m.Service = NewService(m.cfg, col, m.logger)\n    return m.Service.EnsureIndexes(ctx)\n}\n\nfunc (m *Module) Shutdown(ctx context.Context) error {\n    return nil\n}\n",[992,1858,1859,1863,1867,1871,1875,1879,1884,1888,1892,1896,1900,1905,1910,1915,1920,1925,1929,1933,1938,1943,1948,1953,1958,1962,1966,1971,1976,1980,1984,1989,1994,1999,2004,2009,2014,2019,2024,2029,2035,2041,2047,2053,2058,2063,2069,2075],{"__ignoreMap":1002},[1006,1860,1861],{"class":1008,"line":10},[1006,1862,1501],{},[1006,1864,1865],{"class":1008,"line":16},[1006,1866,1507],{"emptyLinePlaceholder":1506},[1006,1868,1869],{"class":1008,"line":22},[1006,1870,1672],{},[1006,1872,1873],{"class":1008,"line":51},[1006,1874,1677],{},[1006,1876,1877],{"class":1008,"line":57},[1006,1878,1507],{"emptyLinePlaceholder":1506},[1006,1880,1881],{"class":1008,"line":102},[1006,1882,1883],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\"\n",[1006,1885,1886],{"class":1008,"line":108},[1006,1887,1696],{},[1006,1889,1890],{"class":1008,"line":114},[1006,1891,1701],{},[1006,1893,1894],{"class":1008,"line":120},[1006,1895,1706],{},[1006,1897,1898],{"class":1008,"line":181},[1006,1899,1507],{"emptyLinePlaceholder":1506},[1006,1901,1902],{"class":1008,"line":186},[1006,1903,1904],{},"func init() {\n",[1006,1906,1907],{"class":1008,"line":191},[1006,1908,1909],{},"    modules.RegisterFactory(\"mymodule\", func(deps modules.ModuleDeps) (modules.Module, error) {\n",[1006,1911,1912],{"class":1008,"line":197},[1006,1913,1914],{},"        cfg := DefaultConfig()\n",[1006,1916,1917],{"class":1008,"line":203},[1006,1918,1919],{},"        return NewModule(deps.DB, cfg, deps.Logger), nil\n",[1006,1921,1922],{"class":1008,"line":214},[1006,1923,1924],{},"    })\n",[1006,1926,1927],{"class":1008,"line":223},[1006,1928,1536],{},[1006,1930,1931],{"class":1008,"line":229},[1006,1932,1507],{"emptyLinePlaceholder":1506},[1006,1934,1935],{"class":1008,"line":234},[1006,1936,1937],{},"type Module struct {\n",[1006,1939,1940],{"class":1008,"line":240},[1006,1941,1942],{},"    Service *Service\n",[1006,1944,1945],{"class":1008,"line":246},[1006,1946,1947],{},"    db      *mongo.Database\n",[1006,1949,1950],{"class":1008,"line":251},[1006,1951,1952],{},"    cfg     *Config\n",[1006,1954,1955],{"class":1008,"line":257},[1006,1956,1957],{},"    logger  *zap.Logger\n",[1006,1959,1960],{"class":1008,"line":1766},[1006,1961,1536],{},[1006,1963,1964],{"class":1008,"line":1771},[1006,1965,1507],{"emptyLinePlaceholder":1506},[1006,1967,1968],{"class":1008,"line":271},[1006,1969,1970],{},"func NewModule(db *mongo.Database, cfg *Config, logger *zap.Logger) *Module {\n",[1006,1972,1973],{"class":1008,"line":277},[1006,1974,1975],{},"    return &Module{db: db, cfg: cfg, logger: logger}\n",[1006,1977,1978],{"class":1008,"line":282},[1006,1979,1536],{},[1006,1981,1982],{"class":1008,"line":1790},[1006,1983,1507],{"emptyLinePlaceholder":1506},[1006,1985,1986],{"class":1008,"line":1795},[1006,1987,1988],{},"func (m *Module) Manifest() *modules.Manifest {\n",[1006,1990,1991],{"class":1008,"line":1800},[1006,1992,1993],{},"    return &modules.Manifest{\n",[1006,1995,1996],{"class":1008,"line":1806},[1006,1997,1998],{},"        Name:        \"mymodule\",\n",[1006,2000,2001],{"class":1008,"line":1812},[1006,2002,2003],{},"        Description: \"My custom module\",\n",[1006,2005,2006],{"class":1008,"line":1818},[1006,2007,2008],{},"        Version:     \"1.0.0\",\n",[1006,2010,2011],{"class":1008,"line":1824},[1006,2012,2013],{},"        Provides:    []string{\"mymodule\"},\n",[1006,2015,2017],{"class":1008,"line":2016},35,[1006,2018,1565],{},[1006,2020,2022],{"class":1008,"line":2021},36,[1006,2023,1536],{},[1006,2025,2027],{"class":1008,"line":2026},37,[1006,2028,1507],{"emptyLinePlaceholder":1506},[1006,2030,2032],{"class":1008,"line":2031},38,[1006,2033,2034],{},"func (m *Module) Startup(ctx context.Context) error {\n",[1006,2036,2038],{"class":1008,"line":2037},39,[1006,2039,2040],{},"    col := m.db.Collection(m.cfg.Collection)\n",[1006,2042,2044],{"class":1008,"line":2043},40,[1006,2045,2046],{},"    m.Service = NewService(m.cfg, col, m.logger)\n",[1006,2048,2050],{"class":1008,"line":2049},41,[1006,2051,2052],{},"    return m.Service.EnsureIndexes(ctx)\n",[1006,2054,2056],{"class":1008,"line":2055},42,[1006,2057,1536],{},[1006,2059,2061],{"class":1008,"line":2060},43,[1006,2062,1507],{"emptyLinePlaceholder":1506},[1006,2064,2066],{"class":1008,"line":2065},44,[1006,2067,2068],{},"func (m *Module) Shutdown(ctx context.Context) error {\n",[1006,2070,2072],{"class":1008,"line":2071},45,[1006,2073,2074],{},"    return nil\n",[1006,2076,2078],{"class":1008,"line":2077},46,[1006,2079,1536],{},[1070,2081,2083],{"id":2082},"step-5-wire-it-up","Step 5: Wire It Up",[978,2085,2086,2087,2090,2091,2093],{},"In your application, add a blank import of ",[987,2088,2089],{},"your module's package"," (your app's\nmodule path, not the framework's) to trigger the ",[992,2092,1173],{}," registration:",[997,2095,2097],{"className":1492,"code":2096,"language":1494,"meta":1002,"style":1002},"import (\n    _ \"github.com\u002Fyourorg\u002Fmyapp\u002Fmodules\u002Fmymodule\"\n)\n\napp := app.New(\"myapp\", logger)\napp.DiscoverAndRegister(modules.ModuleDeps{DB: db, Logger: logger})\napp.Start(ctx)\n",[992,2098,2099,2103,2108,2112,2116,2121,2126],{"__ignoreMap":1002},[1006,2100,2101],{"class":1008,"line":10},[1006,2102,1672],{},[1006,2104,2105],{"class":1008,"line":16},[1006,2106,2107],{},"    _ \"github.com\u002Fyourorg\u002Fmyapp\u002Fmodules\u002Fmymodule\"\n",[1006,2109,2110],{"class":1008,"line":22},[1006,2111,1706],{},[1006,2113,2114],{"class":1008,"line":51},[1006,2115,1507],{"emptyLinePlaceholder":1506},[1006,2117,2118],{"class":1008,"line":57},[1006,2119,2120],{},"app := app.New(\"myapp\", logger)\n",[1006,2122,2123],{"class":1008,"line":102},[1006,2124,2125],{},"app.DiscoverAndRegister(modules.ModuleDeps{DB: db, Logger: logger})\n",[1006,2127,2128],{"class":1008,"line":108},[1006,2129,2130],{},"app.Start(ctx)\n",[1070,2132,2134],{"id":2133},"optional-interfaces","Optional Interfaces",[978,2136,2137],{},"Modules can implement additional interfaces to participate in framework features:",[1141,2139,2140,2150],{},[1144,2141,2142],{},[1147,2143,2144,2147],{},[1150,2145,2146],{},"Interface",[1150,2148,2149],{},"Purpose",[1160,2151,2152,2165,2175,2185,2195,2205,2215,2225,2243,2253,2263,2273,2283,2293],{},[1147,2153,2154,2159],{},[1165,2155,2156],{},[992,2157,2158],{},"RoutesProvider",[1165,2160,2161,2162],{},"Register HTTP API routes via ",[992,2163,2164],{},"Routes(router Router)",[1147,2166,2167,2172],{},[1165,2168,2169],{},[992,2170,2171],{},"EventsProvider",[1165,2173,2174],{},"Define events and consumers",[1147,2176,2177,2182],{},[1165,2178,2179],{},[992,2180,2181],{},"CRUDProvider",[1165,2183,2184],{},"Declare CRUD capabilities",[1147,2186,2187,2192],{},[1165,2188,2189],{},[992,2190,2191],{},"MCPProvider",[1165,2193,2194],{},"Expose MCP tools and resources",[1147,2196,2197,2202],{},[1165,2198,2199],{},[992,2200,2201],{},"CLIProvider",[1165,2203,2204],{},"Contribute CLI commands (auto-exposed via MCP)",[1147,2206,2207,2212],{},[1165,2208,2209],{},[992,2210,2211],{},"ConfigProvider",[1165,2213,2214],{},"Runtime configuration definitions",[1147,2216,2217,2222],{},[1165,2218,2219],{},[992,2220,2221],{},"SettingsProvider",[1165,2223,2224],{},"Admin-UI-editable settings",[1147,2226,2227,2232],{},[1165,2228,2229],{},[992,2230,2231],{},"SchemasProvider",[1165,2233,2234,2235,2238,2239,2242],{},"Publish Go types into ",[992,2236,2237],{},"\u002Fopenapi.json#\u002Fcomponents\u002Fschemas"," without owning an HTTP route — needed when FlowDSL nodes reference types via ",[992,2240,2241],{},"$ref",". See section below.",[1147,2244,2245,2250],{},[1165,2246,2247],{},[992,2248,2249],{},"FlowDSLProvider",[1165,2251,2252],{},"Contribute FlowDSL workflow fragments",[1147,2254,2255,2260],{},[1165,2256,2257],{},[992,2258,2259],{},"TemplateProvider",[1165,2261,2262],{},"Contribute starter flow documents to the Studio's \"Create flow\" picker",[1147,2264,2265,2270],{},[1165,2266,2267],{},[992,2268,2269],{},"DynamicRoutesProvider",[1165,2271,2272],{},"Mount HTTP routes at runtime (typically the flowexec dispatcher for flow-driven endpoints)",[1147,2274,2275,2280],{},[1165,2276,2277],{},[992,2278,2279],{},"DynamicChannelsProvider",[1165,2281,2282],{},"Announce event channels at runtime (flowexec for subscriber deployments)",[1147,2284,2285,2290],{},[1165,2286,2287],{},[992,2288,2289],{},"MigrationsProvider",[1165,2291,2292],{},"Database migration scripts",[1147,2294,2295,2300],{},[1165,2296,2297],{},[992,2298,2299],{},"Configurable",[1165,2301,2302],{},"Resolve cross-module dependencies at startup",[1410,2304,2306],{"id":2305},"example-adding-http-routes","Example: Adding HTTP Routes",[997,2308,2310],{"className":1492,"code":2309,"language":1494,"meta":1002,"style":1002},"func (m *Module) Routes(router modules.Router) {\n    router.Group(\"\u002Fitems\", func(r modules.Router) {\n        r.Handle(\"GET\", \"\", m.handleList)\n        r.Handle(\"POST\", \"\", m.handleCreate)\n        r.Handle(\"GET\", \"\u002F{id}\", m.handleGet)\n        r.Handle(\"PUT\", \"\u002F{id}\", m.handleUpdate)\n        r.Handle(\"DELETE\", \"\u002F{id}\", m.handleDelete)\n    })\n}\n",[992,2311,2312,2317,2322,2327,2332,2337,2342,2347,2351],{"__ignoreMap":1002},[1006,2313,2314],{"class":1008,"line":10},[1006,2315,2316],{},"func (m *Module) Routes(router modules.Router) {\n",[1006,2318,2319],{"class":1008,"line":16},[1006,2320,2321],{},"    router.Group(\"\u002Fitems\", func(r modules.Router) {\n",[1006,2323,2324],{"class":1008,"line":22},[1006,2325,2326],{},"        r.Handle(\"GET\", \"\", m.handleList)\n",[1006,2328,2329],{"class":1008,"line":51},[1006,2330,2331],{},"        r.Handle(\"POST\", \"\", m.handleCreate)\n",[1006,2333,2334],{"class":1008,"line":57},[1006,2335,2336],{},"        r.Handle(\"GET\", \"\u002F{id}\", m.handleGet)\n",[1006,2338,2339],{"class":1008,"line":102},[1006,2340,2341],{},"        r.Handle(\"PUT\", \"\u002F{id}\", m.handleUpdate)\n",[1006,2343,2344],{"class":1008,"line":108},[1006,2345,2346],{},"        r.Handle(\"DELETE\", \"\u002F{id}\", m.handleDelete)\n",[1006,2348,2349],{"class":1008,"line":114},[1006,2350,1924],{},[1006,2352,2353],{"class":1008,"line":120},[1006,2354,1536],{},[978,2356,2357,2358,2361,2362,2365,2366,2369],{},"The server mounts module routes under ",[992,2359,2360],{},"ROUTE_PREFIX"," (default ",[992,2363,2364],{},"\u002Fapi\u002Fv1","), so this serves\n",[992,2367,2368],{},"\u002Fapi\u002Fv1\u002Fitems"," — don't repeat the prefix in the group path.",[978,2371,2372],{},"Routes registered this way are automatically collected by the OpenAPI spec generator and exposed via MCP.",[1410,2374,2376,2377,1251],{"id":2375},"example-publishing-schemas-without-routes-schemasprovider","Example: Publishing Schemas Without Routes (",[992,2378,2231],{},[978,2380,2381,2382,2385,2386,2389,2390,2393,2394,2397],{},"When a module ships FlowDSL nodes whose port specs reference Go\ntypes (",[992,2383,2384],{},"$ref: \"openapi:default#\u002Fcomponents\u002Fschemas\u002FUserCreateInput\"","),\nthe OpenAPI spec generator needs to find those types in\n",[992,2387,2388],{},"components\u002Fschemas",". The reflection registry only sees types declared\non actual HTTP routes (",[992,2391,2392],{},"Body(...)"," \u002F ",[992,2395,2396],{},"Response(...)",") — types used\nONLY by FlowDSL nodes need a separate publishing path.",[978,2399,2400,2401,2403],{},"Implement ",[992,2402,2231],{},":",[997,2405,2407],{"className":1492,"code":2406,"language":1494,"meta":1002,"style":1002},"\u002F\u002F OpenAPISchemas publishes Go types into \u002Fopenapi.json's\n\u002F\u002F components\u002Fschemas. Each entry is a pointer to a zero-value struct;\n\u002F\u002F the openapi module reflects them via its existing schema registry.\nfunc (m *Module) OpenAPISchemas() []any {\n    return []any{\n        &UserCreateInput{},\n        &UserUpdateInput{},\n        &UserResponse{},\n        &UserListResponse{},\n    }\n}\n",[992,2408,2409,2414,2419,2424,2429,2434,2439,2444,2449,2454,2458],{"__ignoreMap":1002},[1006,2410,2411],{"class":1008,"line":10},[1006,2412,2413],{},"\u002F\u002F OpenAPISchemas publishes Go types into \u002Fopenapi.json's\n",[1006,2415,2416],{"class":1008,"line":16},[1006,2417,2418],{},"\u002F\u002F components\u002Fschemas. Each entry is a pointer to a zero-value struct;\n",[1006,2420,2421],{"class":1008,"line":22},[1006,2422,2423],{},"\u002F\u002F the openapi module reflects them via its existing schema registry.\n",[1006,2425,2426],{"class":1008,"line":51},[1006,2427,2428],{},"func (m *Module) OpenAPISchemas() []any {\n",[1006,2430,2431],{"class":1008,"line":57},[1006,2432,2433],{},"    return []any{\n",[1006,2435,2436],{"class":1008,"line":102},[1006,2437,2438],{},"        &UserCreateInput{},\n",[1006,2440,2441],{"class":1008,"line":108},[1006,2442,2443],{},"        &UserUpdateInput{},\n",[1006,2445,2446],{"class":1008,"line":114},[1006,2447,2448],{},"        &UserResponse{},\n",[1006,2450,2451],{"class":1008,"line":120},[1006,2452,2453],{},"        &UserListResponse{},\n",[1006,2455,2456],{"class":1008,"line":181},[1006,2457,1565],{},[1006,2459,2460],{"class":1008,"line":186},[1006,2461,1536],{},[978,2463,2464,2465,2467,2468,2471],{},"Without this, a flow-driven endpoint whose packet refs ",[992,2466,1247],{},"\nwould render \"Schema not found in loaded specs\" in Studio and 404 on\nthe spec lookup. Modules that already declare every type via Go\nHTTP handlers don't need to duplicate them here — only types\nreferenced by FlowDSL nodes \u002F packets \u002F dynamic routes that have no\nmatching ",[992,2469,2470],{},"Body()"," reflection path do.",[982,2473,2474,2477,2478,2480,2481,2483,2484,2487],{"icon":11},[987,2475,2476],{},"File-split rule for wire shapes."," Request\u002Fresponse\u002Fconflict types\ndo NOT live in ",[992,2479,1063],{},". They go in ",[992,2482,1117],{}," even when only\none handler reads them — keeps the handler file focused on routing\nand business logic, and makes the wire surface easy to scan in one\nfile. The same rule applies to admin sub-modules (",[992,2485,2486],{},"module\u002Fadmin\u002Fschemas.go",")\nand flowdsl companion modules.",[1410,2489,2491,2492,1251],{"id":2490},"example-exposing-mcp-tools-mcpprovider","Example: Exposing MCP Tools (",[992,2493,2191],{},[978,2495,2400,2496,2498,2499,2502],{},[992,2497,2191],{}," to expose your module's capabilities as tools for AI assistants via the MCP server at ",[992,2500,2501],{},"\u002Fmcp",". This lets Claude, Copilot, Cursor, and other MCP clients discover and invoke your module's operations.",[997,2504,2506],{"className":1492,"code":2505,"language":1494,"meta":1002,"style":1002},"func (m *Module) MCPTools() []modules.MCPTool {\n    return []modules.MCPTool{\n        {\n            Name:        \"search_items\",\n            Description: \"Search items by name or category\",\n            InputSchema: map[string]any{\n                \"type\":     \"object\",\n                \"required\": []string{\"query\"},\n                \"properties\": map[string]any{\n                    \"query\": map[string]any{\n                        \"type\":        \"string\",\n                        \"description\": \"Search term\",\n                    },\n                },\n            },\n            Handler: func(ctx context.Context, args map[string]any) (any, error) {\n                query, _ := args[\"query\"].(string)\n                return m.service.Search(ctx, query)\n            },\n        },\n    }\n}\n\nfunc (m *Module) MCPResources() []modules.MCPResource { return nil }\n",[992,2507,2508,2513,2518,2523,2528,2533,2538,2543,2548,2553,2558,2563,2568,2573,2578,2583,2588,2593,2598,2602,2607,2611,2615,2619],{"__ignoreMap":1002},[1006,2509,2510],{"class":1008,"line":10},[1006,2511,2512],{},"func (m *Module) MCPTools() []modules.MCPTool {\n",[1006,2514,2515],{"class":1008,"line":16},[1006,2516,2517],{},"    return []modules.MCPTool{\n",[1006,2519,2520],{"class":1008,"line":22},[1006,2521,2522],{},"        {\n",[1006,2524,2525],{"class":1008,"line":51},[1006,2526,2527],{},"            Name:        \"search_items\",\n",[1006,2529,2530],{"class":1008,"line":57},[1006,2531,2532],{},"            Description: \"Search items by name or category\",\n",[1006,2534,2535],{"class":1008,"line":102},[1006,2536,2537],{},"            InputSchema: map[string]any{\n",[1006,2539,2540],{"class":1008,"line":108},[1006,2541,2542],{},"                \"type\":     \"object\",\n",[1006,2544,2545],{"class":1008,"line":114},[1006,2546,2547],{},"                \"required\": []string{\"query\"},\n",[1006,2549,2550],{"class":1008,"line":120},[1006,2551,2552],{},"                \"properties\": map[string]any{\n",[1006,2554,2555],{"class":1008,"line":181},[1006,2556,2557],{},"                    \"query\": map[string]any{\n",[1006,2559,2560],{"class":1008,"line":186},[1006,2561,2562],{},"                        \"type\":        \"string\",\n",[1006,2564,2565],{"class":1008,"line":191},[1006,2566,2567],{},"                        \"description\": \"Search term\",\n",[1006,2569,2570],{"class":1008,"line":197},[1006,2571,2572],{},"                    },\n",[1006,2574,2575],{"class":1008,"line":203},[1006,2576,2577],{},"                },\n",[1006,2579,2580],{"class":1008,"line":214},[1006,2581,2582],{},"            },\n",[1006,2584,2585],{"class":1008,"line":223},[1006,2586,2587],{},"            Handler: func(ctx context.Context, args map[string]any) (any, error) {\n",[1006,2589,2590],{"class":1008,"line":229},[1006,2591,2592],{},"                query, _ := args[\"query\"].(string)\n",[1006,2594,2595],{"class":1008,"line":234},[1006,2596,2597],{},"                return m.service.Search(ctx, query)\n",[1006,2599,2600],{"class":1008,"line":240},[1006,2601,2582],{},[1006,2603,2604],{"class":1008,"line":246},[1006,2605,2606],{},"        },\n",[1006,2608,2609],{"class":1008,"line":251},[1006,2610,1565],{},[1006,2612,2613],{"class":1008,"line":257},[1006,2614,1536],{},[1006,2616,2617],{"class":1008,"line":1766},[1006,2618,1507],{"emptyLinePlaceholder":1506},[1006,2620,2621],{"class":1008,"line":1771},[1006,2622,2623],{},"func (m *Module) MCPResources() []modules.MCPResource { return nil }\n",[978,2625,2626,2627,2630],{},"The MCP server auto-discovers your tools at startup — no extra wiring needed. Use ",[992,2628,2629],{},"InputSchema"," to define a JSON Schema for the tool's parameters so AI clients understand what arguments to provide.",[2632,2633,2634],"blockquote",{},[978,2635,2636,2639,2640,2643],{},[987,2637,2638],{},"Tip:"," You can also expose ",[992,2641,2642],{},"MCPResource"," entries for static data (e.g. a config summary or schema document) that AI assistants can read without invoking a tool.",[1410,2645,2647,2648,1251],{"id":2646},"example-publishing-and-consuming-events-eventsprovider","Example: Publishing and Consuming Events (",[992,2649,2171],{},[978,2651,2400,2652,2654],{},[992,2653,2171],{}," when your module publishes or consumes events. This serves two purposes:",[1837,2656,2657,2667],{},[1112,2658,2659,2662,2663,2666],{},[987,2660,2661],{},"IR metadata"," — ",[992,2664,2665],{},"Events()"," populates the modspec browser and AsyncAPI spec",[1112,2668,2669,2662,2672,2674,2675],{},[987,2670,2671],{},"Runtime wiring",[992,2673,1332],{}," registers handlers before ",[992,2676,2677],{},"bus.Start()",[978,2679,2680,2681,2683,2684,2686],{},"First, define a ",[992,2682,1350],{}," (can be in ",[992,2685,1133],{},"):",[997,2688,2690],{"className":1492,"code":2689,"language":1494,"meta":1002,"style":1002},"package mymodule\n\nimport \"github.com\u002Fredelay\u002Fgo-events\u002Ftyped\"\n\ntype ItemCreatedPayload struct {\n    ItemID string `json:\"item_id\"`\n    Name   string `json:\"name\"`\n}\n\nvar ItemCreatedEvent = typed.EventDefinition[ItemCreatedPayload]{\n    Name:       \"item.created\",\n    EntityType: \"item\",\n    Action:     \"created\",\n    Topic:      \"item.created\",\n}\n",[992,2691,2692,2696,2700,2705,2709,2714,2719,2724,2728,2732,2737,2742,2747,2752,2757],{"__ignoreMap":1002},[1006,2693,2694],{"class":1008,"line":10},[1006,2695,1501],{},[1006,2697,2698],{"class":1008,"line":16},[1006,2699,1507],{"emptyLinePlaceholder":1506},[1006,2701,2702],{"class":1008,"line":22},[1006,2703,2704],{},"import \"github.com\u002Fredelay\u002Fgo-events\u002Ftyped\"\n",[1006,2706,2707],{"class":1008,"line":51},[1006,2708,1507],{"emptyLinePlaceholder":1506},[1006,2710,2711],{"class":1008,"line":57},[1006,2712,2713],{},"type ItemCreatedPayload struct {\n",[1006,2715,2716],{"class":1008,"line":102},[1006,2717,2718],{},"    ItemID string `json:\"item_id\"`\n",[1006,2720,2721],{"class":1008,"line":108},[1006,2722,2723],{},"    Name   string `json:\"name\"`\n",[1006,2725,2726],{"class":1008,"line":114},[1006,2727,1536],{},[1006,2729,2730],{"class":1008,"line":120},[1006,2731,1507],{"emptyLinePlaceholder":1506},[1006,2733,2734],{"class":1008,"line":181},[1006,2735,2736],{},"var ItemCreatedEvent = typed.EventDefinition[ItemCreatedPayload]{\n",[1006,2738,2739],{"class":1008,"line":186},[1006,2740,2741],{},"    Name:       \"item.created\",\n",[1006,2743,2744],{"class":1008,"line":191},[1006,2745,2746],{},"    EntityType: \"item\",\n",[1006,2748,2749],{"class":1008,"line":197},[1006,2750,2751],{},"    Action:     \"created\",\n",[1006,2753,2754],{"class":1008,"line":203},[1006,2755,2756],{},"    Topic:      \"item.created\",\n",[1006,2758,2759],{"class":1008,"line":214},[1006,2760,1536],{},[978,2762,2763,2764,1084,2766,2768,2769,2772,2773,2403],{},"Then implement ",[992,2765,2171],{},[992,2767,1041],{},". The module also needs access to the ",[992,2770,2771],{},"EventBus"," from ",[992,2774,2775],{},"ModuleDeps",[997,2777,2779],{"className":1492,"code":2778,"language":1494,"meta":1002,"style":1002},"func init() {\n    modules.RegisterFactory(\"mymodule\", func(deps modules.ModuleDeps) (modules.Module, error) {\n        cfg := DefaultConfig()\n        return NewModule(deps.DB, cfg, deps.Logger, deps.EventBus), nil\n    })\n}\n\ntype Module struct {\n    Service  *Service\n    db       *mongo.Database\n    cfg      *Config\n    logger   *zap.Logger\n    eventBus modules.EventBus\n}\n\nfunc NewModule(db *mongo.Database, cfg *Config, logger *zap.Logger, bus modules.EventBus) *Module {\n    return &Module{db: db, cfg: cfg, logger: logger, eventBus: bus}\n}\n\n\u002F\u002F Events returns IR metadata for modspec and AsyncAPI generation.\nfunc (m *Module) Events() []*ir.Event {\n    return []*ir.Event{\n        {Name: \"item.created\", EntityType: \"item\", Action: \"created\"},\n    }\n}\n\n\u002F\u002F Consumers returns runtime subscriptions — wired before bus.Start().\nfunc (m *Module) Consumers() []*modules.ConsumerRegistration {\n    return []*modules.ConsumerRegistration{\n        {\n            EventName: \"order.completed\",\n            Topic:     \"order.completed\",\n            GroupID:   \"mymodule\",\n            Handler:   m.handleOrderCompleted,\n        },\n    }\n}\n\nfunc (m *Module) handleOrderCompleted(ctx context.Context, msg *modules.EventMessage) error {\n    var p OrderCompletedPayload\n    if err := json.Unmarshal(msg.Payload, &p); err != nil {\n        return err\n    }\n    \u002F\u002F ... business logic\n    return nil\n}\n",[992,2780,2781,2785,2789,2793,2798,2802,2806,2810,2814,2819,2824,2829,2834,2839,2843,2847,2852,2857,2861,2865,2870,2875,2880,2885,2889,2893,2897,2902,2907,2912,2916,2921,2926,2931,2936,2940,2944,2948,2952,2957,2962,2967,2972,2976,2981,2985],{"__ignoreMap":1002},[1006,2782,2783],{"class":1008,"line":10},[1006,2784,1904],{},[1006,2786,2787],{"class":1008,"line":16},[1006,2788,1909],{},[1006,2790,2791],{"class":1008,"line":22},[1006,2792,1914],{},[1006,2794,2795],{"class":1008,"line":51},[1006,2796,2797],{},"        return NewModule(deps.DB, cfg, deps.Logger, deps.EventBus), nil\n",[1006,2799,2800],{"class":1008,"line":57},[1006,2801,1924],{},[1006,2803,2804],{"class":1008,"line":102},[1006,2805,1536],{},[1006,2807,2808],{"class":1008,"line":108},[1006,2809,1507],{"emptyLinePlaceholder":1506},[1006,2811,2812],{"class":1008,"line":114},[1006,2813,1937],{},[1006,2815,2816],{"class":1008,"line":120},[1006,2817,2818],{},"    Service  *Service\n",[1006,2820,2821],{"class":1008,"line":181},[1006,2822,2823],{},"    db       *mongo.Database\n",[1006,2825,2826],{"class":1008,"line":186},[1006,2827,2828],{},"    cfg      *Config\n",[1006,2830,2831],{"class":1008,"line":191},[1006,2832,2833],{},"    logger   *zap.Logger\n",[1006,2835,2836],{"class":1008,"line":197},[1006,2837,2838],{},"    eventBus modules.EventBus\n",[1006,2840,2841],{"class":1008,"line":203},[1006,2842,1536],{},[1006,2844,2845],{"class":1008,"line":214},[1006,2846,1507],{"emptyLinePlaceholder":1506},[1006,2848,2849],{"class":1008,"line":223},[1006,2850,2851],{},"func NewModule(db *mongo.Database, cfg *Config, logger *zap.Logger, bus modules.EventBus) *Module {\n",[1006,2853,2854],{"class":1008,"line":229},[1006,2855,2856],{},"    return &Module{db: db, cfg: cfg, logger: logger, eventBus: bus}\n",[1006,2858,2859],{"class":1008,"line":234},[1006,2860,1536],{},[1006,2862,2863],{"class":1008,"line":240},[1006,2864,1507],{"emptyLinePlaceholder":1506},[1006,2866,2867],{"class":1008,"line":246},[1006,2868,2869],{},"\u002F\u002F Events returns IR metadata for modspec and AsyncAPI generation.\n",[1006,2871,2872],{"class":1008,"line":251},[1006,2873,2874],{},"func (m *Module) Events() []*ir.Event {\n",[1006,2876,2877],{"class":1008,"line":257},[1006,2878,2879],{},"    return []*ir.Event{\n",[1006,2881,2882],{"class":1008,"line":1766},[1006,2883,2884],{},"        {Name: \"item.created\", EntityType: \"item\", Action: \"created\"},\n",[1006,2886,2887],{"class":1008,"line":1771},[1006,2888,1565],{},[1006,2890,2891],{"class":1008,"line":271},[1006,2892,1536],{},[1006,2894,2895],{"class":1008,"line":277},[1006,2896,1507],{"emptyLinePlaceholder":1506},[1006,2898,2899],{"class":1008,"line":282},[1006,2900,2901],{},"\u002F\u002F Consumers returns runtime subscriptions — wired before bus.Start().\n",[1006,2903,2904],{"class":1008,"line":1790},[1006,2905,2906],{},"func (m *Module) Consumers() []*modules.ConsumerRegistration {\n",[1006,2908,2909],{"class":1008,"line":1795},[1006,2910,2911],{},"    return []*modules.ConsumerRegistration{\n",[1006,2913,2914],{"class":1008,"line":1800},[1006,2915,2522],{},[1006,2917,2918],{"class":1008,"line":1806},[1006,2919,2920],{},"            EventName: \"order.completed\",\n",[1006,2922,2923],{"class":1008,"line":1812},[1006,2924,2925],{},"            Topic:     \"order.completed\",\n",[1006,2927,2928],{"class":1008,"line":1818},[1006,2929,2930],{},"            GroupID:   \"mymodule\",\n",[1006,2932,2933],{"class":1008,"line":1824},[1006,2934,2935],{},"            Handler:   m.handleOrderCompleted,\n",[1006,2937,2938],{"class":1008,"line":2016},[1006,2939,2606],{},[1006,2941,2942],{"class":1008,"line":2021},[1006,2943,1565],{},[1006,2945,2946],{"class":1008,"line":2026},[1006,2947,1536],{},[1006,2949,2950],{"class":1008,"line":2031},[1006,2951,1507],{"emptyLinePlaceholder":1506},[1006,2953,2954],{"class":1008,"line":2037},[1006,2955,2956],{},"func (m *Module) handleOrderCompleted(ctx context.Context, msg *modules.EventMessage) error {\n",[1006,2958,2959],{"class":1008,"line":2043},[1006,2960,2961],{},"    var p OrderCompletedPayload\n",[1006,2963,2964],{"class":1008,"line":2049},[1006,2965,2966],{},"    if err := json.Unmarshal(msg.Payload, &p); err != nil {\n",[1006,2968,2969],{"class":1008,"line":2055},[1006,2970,2971],{},"        return err\n",[1006,2973,2974],{"class":1008,"line":2060},[1006,2975,1565],{},[1006,2977,2978],{"class":1008,"line":2065},[1006,2979,2980],{},"    \u002F\u002F ... business logic\n",[1006,2982,2983],{"class":1008,"line":2071},[1006,2984,2074],{},[1006,2986,2987],{"class":1008,"line":2077},[1006,2988,1536],{},[978,2990,2991,2992,2994,2995,2998,2999,3002,3003,2403],{},"Publish an event from a service method. Give the ",[992,2993,1650],{}," the bus — add an\n",[992,2996,2997],{},"eventBus"," field and pass ",[992,3000,3001],{},"m.eventBus"," through from ",[992,3004,1181],{},[997,3006,3008],{"className":1492,"code":3007,"language":1494,"meta":1002,"style":1002},"type Service struct {\n    cfg      *Config\n    crud     *crud.MongoCRUD[*Item]\n    eventBus modules.EventBus\n    logger   *zap.Logger\n}\n\nfunc NewService(cfg *Config, col *mongo.Collection, bus modules.EventBus, logger *zap.Logger) *Service {\n    return &Service{cfg: cfg, crud: crud.NewMongoCRUD[*Item](col), eventBus: bus, logger: logger.Named(\"mymodule\")}\n}\n\n\u002F\u002F in (m *Module) Startup:\n\u002F\u002F     m.Service = NewService(m.cfg, col, m.eventBus, m.logger)\n\nfunc (s *Service) Create(ctx context.Context, name string) (*Item, error) {\n    item, err := s.crud.Create(ctx, &Item{Name: name})\n    if err != nil {\n        return nil, err\n    }\n    if s.eventBus != nil {\n        msg, _ := ItemCreatedEvent.NewMessage(\n            item.ID.Hex(),\n            typed.SystemActor,\n            ItemCreatedPayload{ItemID: item.ID.Hex(), Name: item.Name},\n        )\n        _ = s.eventBus.Publish(ctx, msg)\n    }\n    return item, nil\n}\n",[992,3009,3010,3014,3018,3023,3027,3031,3035,3039,3044,3049,3053,3057,3062,3067,3071,3075,3080,3085,3090,3094,3099,3104,3109,3114,3119,3124,3129,3133,3138],{"__ignoreMap":1002},[1006,3011,3012],{"class":1008,"line":10},[1006,3013,1715],{},[1006,3015,3016],{"class":1008,"line":16},[1006,3017,2828],{},[1006,3019,3020],{"class":1008,"line":22},[1006,3021,3022],{},"    crud     *crud.MongoCRUD[*Item]\n",[1006,3024,3025],{"class":1008,"line":51},[1006,3026,2838],{},[1006,3028,3029],{"class":1008,"line":57},[1006,3030,2833],{},[1006,3032,3033],{"class":1008,"line":102},[1006,3034,1536],{},[1006,3036,3037],{"class":1008,"line":108},[1006,3038,1507],{"emptyLinePlaceholder":1506},[1006,3040,3041],{"class":1008,"line":114},[1006,3042,3043],{},"func NewService(cfg *Config, col *mongo.Collection, bus modules.EventBus, logger *zap.Logger) *Service {\n",[1006,3045,3046],{"class":1008,"line":120},[1006,3047,3048],{},"    return &Service{cfg: cfg, crud: crud.NewMongoCRUD[*Item](col), eventBus: bus, logger: logger.Named(\"mymodule\")}\n",[1006,3050,3051],{"class":1008,"line":181},[1006,3052,1536],{},[1006,3054,3055],{"class":1008,"line":186},[1006,3056,1507],{"emptyLinePlaceholder":1506},[1006,3058,3059],{"class":1008,"line":191},[1006,3060,3061],{},"\u002F\u002F in (m *Module) Startup:\n",[1006,3063,3064],{"class":1008,"line":197},[1006,3065,3066],{},"\u002F\u002F     m.Service = NewService(m.cfg, col, m.eventBus, m.logger)\n",[1006,3068,3069],{"class":1008,"line":203},[1006,3070,1507],{"emptyLinePlaceholder":1506},[1006,3072,3073],{"class":1008,"line":214},[1006,3074,1782],{},[1006,3076,3077],{"class":1008,"line":223},[1006,3078,3079],{},"    item, err := s.crud.Create(ctx, &Item{Name: name})\n",[1006,3081,3082],{"class":1008,"line":229},[1006,3083,3084],{},"    if err != nil {\n",[1006,3086,3087],{"class":1008,"line":234},[1006,3088,3089],{},"        return nil, err\n",[1006,3091,3092],{"class":1008,"line":240},[1006,3093,1565],{},[1006,3095,3096],{"class":1008,"line":246},[1006,3097,3098],{},"    if s.eventBus != nil {\n",[1006,3100,3101],{"class":1008,"line":251},[1006,3102,3103],{},"        msg, _ := ItemCreatedEvent.NewMessage(\n",[1006,3105,3106],{"class":1008,"line":257},[1006,3107,3108],{},"            item.ID.Hex(),\n",[1006,3110,3111],{"class":1008,"line":1766},[1006,3112,3113],{},"            typed.SystemActor,\n",[1006,3115,3116],{"class":1008,"line":1771},[1006,3117,3118],{},"            ItemCreatedPayload{ItemID: item.ID.Hex(), Name: item.Name},\n",[1006,3120,3121],{"class":1008,"line":271},[1006,3122,3123],{},"        )\n",[1006,3125,3126],{"class":1008,"line":277},[1006,3127,3128],{},"        _ = s.eventBus.Publish(ctx, msg)\n",[1006,3130,3131],{"class":1008,"line":282},[1006,3132,1565],{},[1006,3134,3135],{"class":1008,"line":1790},[1006,3136,3137],{},"    return item, nil\n",[1006,3139,3140],{"class":1008,"line":1795},[1006,3141,1536],{},[2632,3143,3144],{},[978,3145,3146,3147,3150,3151,3154],{},"Guard ",[992,3148,3149],{},"eventBus != nil"," when EventBus is optional for your module. Apps without an\nevent transport configured will pass ",[992,3152,3153],{},"nil"," — the guard makes the module work in both modes.",[1410,3156,3158,3159,1251],{"id":3157},"example-cross-module-dependencies-configurable","Example: Cross-Module Dependencies (",[992,3160,2299],{},[978,3162,3163,3164,2403],{},"If your module depends on another module (e.g., auth needs users), implement ",[992,3165,2299],{},[997,3167,3169],{"className":1492,"code":3168,"language":1494,"meta":1002,"style":1002},"func (m *Module) Configure(registry *modules.Registry) error {\n    usersModule := registry.Get(\"users\")\n    if usersModule == nil {\n        return fmt.Errorf(\"mymodule: requires 'users' module\")\n    }\n    \u002F\u002F Type-assert to access the concrete module\n    return nil\n}\n",[992,3170,3171,3176,3181,3186,3191,3195,3200,3204],{"__ignoreMap":1002},[1006,3172,3173],{"class":1008,"line":10},[1006,3174,3175],{},"func (m *Module) Configure(registry *modules.Registry) error {\n",[1006,3177,3178],{"class":1008,"line":16},[1006,3179,3180],{},"    usersModule := registry.Get(\"users\")\n",[1006,3182,3183],{"class":1008,"line":22},[1006,3184,3185],{},"    if usersModule == nil {\n",[1006,3187,3188],{"class":1008,"line":51},[1006,3189,3190],{},"        return fmt.Errorf(\"mymodule: requires 'users' module\")\n",[1006,3192,3193],{"class":1008,"line":57},[1006,3194,1565],{},[1006,3196,3197],{"class":1008,"line":102},[1006,3198,3199],{},"    \u002F\u002F Type-assert to access the concrete module\n",[1006,3201,3202],{"class":1008,"line":108},[1006,3203,2074],{},[1006,3205,3206],{"class":1008,"line":114},[1006,3207,1536],{},[978,3209,3210,3211,3214],{},"Use ",[992,3212,3213],{},"DependsOn"," in the manifest to ensure correct startup order:",[997,3216,3218],{"className":1492,"code":3217,"language":1494,"meta":1002,"style":1002},"func (m *Module) Manifest() *modules.Manifest {\n    return &modules.Manifest{\n        Name:      \"mymodule\",\n        DependsOn: []string{\"users\"},\n    }\n}\n",[992,3219,3220,3224,3228,3233,3238,3242],{"__ignoreMap":1002},[1006,3221,3222],{"class":1008,"line":10},[1006,3223,1988],{},[1006,3225,3226],{"class":1008,"line":16},[1006,3227,1993],{},[1006,3229,3230],{"class":1008,"line":22},[1006,3231,3232],{},"        Name:      \"mymodule\",\n",[1006,3234,3235],{"class":1008,"line":51},[1006,3236,3237],{},"        DependsOn: []string{\"users\"},\n",[1006,3239,3240],{"class":1008,"line":57},[1006,3241,1565],{},[1006,3243,3244],{"class":1008,"line":102},[1006,3245,1536],{},[1410,3247,3249,3250,1251],{"id":3248},"example-contributing-cli-commands-cliprovider","Example: Contributing CLI Commands (",[992,3251,2201],{},[978,3253,2400,3254,3256,3257,3260],{},[992,3255,2201],{}," to contribute commands to the project CLI. Commands are automatically exposed as MCP tools (prefixed ",[992,3258,3259],{},"cli_",") so AI assistants can invoke them too.",[997,3262,3264],{"className":1492,"code":3263,"language":1494,"meta":1002,"style":1002},"func (m *Module) CLICommands() []modules.CLICommand {\n    return []modules.CLICommand{\n        {\n            Name:        \"create-item\",\n            Description: \"Create a new item from the command line\",\n            Args: []modules.CLIArg{\n                {Name: \"name\", Description: \"Item name\", Required: true},\n                {Name: \"category\", Description: \"Item category\", Required: false, Default: \"general\"},\n                {Name: \"published\", Description: \"Mark as published\", Flag: true, Default: \"false\"},\n            },\n            Handler: m.cliCreateItem,\n        },\n    }\n}\n\nfunc (m *Module) cliCreateItem(ctx context.Context, args map[string]string) error {\n    \u002F\u002F args[\"category\"] and args[\"published\"] are read the same way.\n    item, err := m.Service.Create(ctx, args[\"name\"])\n    if err != nil {\n        return err\n    }\n    fmt.Printf(\"Created item: %s (%s)\\n\", item.Name, item.ID.Hex())\n    return nil\n}\n",[992,3265,3266,3271,3276,3280,3285,3290,3295,3300,3305,3310,3314,3319,3323,3327,3331,3335,3340,3345,3350,3354,3358,3362,3367,3371],{"__ignoreMap":1002},[1006,3267,3268],{"class":1008,"line":10},[1006,3269,3270],{},"func (m *Module) CLICommands() []modules.CLICommand {\n",[1006,3272,3273],{"class":1008,"line":16},[1006,3274,3275],{},"    return []modules.CLICommand{\n",[1006,3277,3278],{"class":1008,"line":22},[1006,3279,2522],{},[1006,3281,3282],{"class":1008,"line":51},[1006,3283,3284],{},"            Name:        \"create-item\",\n",[1006,3286,3287],{"class":1008,"line":57},[1006,3288,3289],{},"            Description: \"Create a new item from the command line\",\n",[1006,3291,3292],{"class":1008,"line":102},[1006,3293,3294],{},"            Args: []modules.CLIArg{\n",[1006,3296,3297],{"class":1008,"line":108},[1006,3298,3299],{},"                {Name: \"name\", Description: \"Item name\", Required: true},\n",[1006,3301,3302],{"class":1008,"line":114},[1006,3303,3304],{},"                {Name: \"category\", Description: \"Item category\", Required: false, Default: \"general\"},\n",[1006,3306,3307],{"class":1008,"line":120},[1006,3308,3309],{},"                {Name: \"published\", Description: \"Mark as published\", Flag: true, Default: \"false\"},\n",[1006,3311,3312],{"class":1008,"line":181},[1006,3313,2582],{},[1006,3315,3316],{"class":1008,"line":186},[1006,3317,3318],{},"            Handler: m.cliCreateItem,\n",[1006,3320,3321],{"class":1008,"line":191},[1006,3322,2606],{},[1006,3324,3325],{"class":1008,"line":197},[1006,3326,1565],{},[1006,3328,3329],{"class":1008,"line":203},[1006,3330,1536],{},[1006,3332,3333],{"class":1008,"line":214},[1006,3334,1507],{"emptyLinePlaceholder":1506},[1006,3336,3337],{"class":1008,"line":223},[1006,3338,3339],{},"func (m *Module) cliCreateItem(ctx context.Context, args map[string]string) error {\n",[1006,3341,3342],{"class":1008,"line":229},[1006,3343,3344],{},"    \u002F\u002F args[\"category\"] and args[\"published\"] are read the same way.\n",[1006,3346,3347],{"class":1008,"line":234},[1006,3348,3349],{},"    item, err := m.Service.Create(ctx, args[\"name\"])\n",[1006,3351,3352],{"class":1008,"line":240},[1006,3353,3084],{},[1006,3355,3356],{"class":1008,"line":246},[1006,3357,2971],{},[1006,3359,3360],{"class":1008,"line":251},[1006,3361,1565],{},[1006,3363,3364],{"class":1008,"line":257},[1006,3365,3366],{},"    fmt.Printf(\"Created item: %s (%s)\\n\", item.Name, item.ID.Hex())\n",[1006,3368,3369],{"class":1008,"line":1766},[1006,3370,2074],{},[1006,3372,3373],{"class":1008,"line":1771},[1006,3374,1536],{},[978,3376,3377,3378,3381,3382,2403],{},"The project needs a ",[992,3379,3380],{},"cmd\u002Fredelayctl\u002Fmain.go"," entry point that blank-imports the same modules as the API and calls ",[992,3383,3384],{},"app.RunCLI()",[997,3386,3388],{"className":1492,"code":3387,"language":1494,"meta":1002,"style":1002},"package main\n\nimport (\n    \"os\"\n\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fauth\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fusers\"\n    \u002F\u002F ... other modules\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fapp\"\n)\n\nfunc main() {\n    if err := app.RunCLI(); err != nil {\n        os.Exit(1)\n    }\n}\n",[992,3389,3390,3395,3399,3403,3408,3412,3417,3422,3427,3432,3436,3440,3445,3450,3455,3459],{"__ignoreMap":1002},[1006,3391,3392],{"class":1008,"line":10},[1006,3393,3394],{},"package main\n",[1006,3396,3397],{"class":1008,"line":16},[1006,3398,1507],{"emptyLinePlaceholder":1506},[1006,3400,3401],{"class":1008,"line":22},[1006,3402,1672],{},[1006,3404,3405],{"class":1008,"line":51},[1006,3406,3407],{},"    \"os\"\n",[1006,3409,3410],{"class":1008,"line":57},[1006,3411,1507],{"emptyLinePlaceholder":1506},[1006,3413,3414],{"class":1008,"line":102},[1006,3415,3416],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fauth\"\n",[1006,3418,3419],{"class":1008,"line":108},[1006,3420,3421],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fusers\"\n",[1006,3423,3424],{"class":1008,"line":114},[1006,3425,3426],{},"    \u002F\u002F ... other modules\n",[1006,3428,3429],{"class":1008,"line":120},[1006,3430,3431],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fapp\"\n",[1006,3433,3434],{"class":1008,"line":181},[1006,3435,1706],{},[1006,3437,3438],{"class":1008,"line":186},[1006,3439,1507],{"emptyLinePlaceholder":1506},[1006,3441,3442],{"class":1008,"line":191},[1006,3443,3444],{},"func main() {\n",[1006,3446,3447],{"class":1008,"line":197},[1006,3448,3449],{},"    if err := app.RunCLI(); err != nil {\n",[1006,3451,3452],{"class":1008,"line":203},[1006,3453,3454],{},"        os.Exit(1)\n",[1006,3456,3457],{"class":1008,"line":214},[1006,3458,1565],{},[1006,3460,3461],{"class":1008,"line":223},[1006,3462,1536],{},[978,3464,3465],{},"Usage:",[997,3467,3469],{"className":999,"code":3468,"language":1001,"meta":1002,"style":1002},"go run .\u002Fcmd\u002Fredelayctl create-item --name=\"Widget\" --category=tools --published\ngo run .\u002Fcmd\u002Fredelayctl help  # list all available commands\n",[992,3470,3471,3502],{"__ignoreMap":1002},[1006,3472,3473,3475,3478,3481,3484,3487,3491,3494,3496,3499],{"class":1008,"line":10},[1006,3474,1494],{"class":1011},[1006,3476,3477],{"class":1015}," run",[1006,3479,3480],{"class":1015}," .\u002Fcmd\u002Fredelayctl",[1006,3482,3483],{"class":1015}," create-item",[1006,3485,3486],{"class":1015}," --name=",[1006,3488,3490],{"class":3489},"sMK4o","\"",[1006,3492,3493],{"class":1015},"Widget",[1006,3495,3490],{"class":3489},[1006,3497,3498],{"class":1015}," --category=tools",[1006,3500,3501],{"class":1015}," --published\n",[1006,3503,3504,3506,3508,3510,3513],{"class":1008,"line":16},[1006,3505,1494],{"class":1011},[1006,3507,3477],{"class":1015},[1006,3509,3480],{"class":1015},[1006,3511,3512],{"class":1015}," help",[1006,3514,3515],{"class":1022},"  # list all available commands\n",[1410,3517,3519,3520,1251],{"id":3518},"example-contributing-flow-templates-templateprovider","Example: Contributing Flow Templates (",[992,3521,2259],{},[978,3523,3524,3525,3528],{},"Any module can ship one or more ",[987,3526,3527],{},"starter flows"," that show up in the FlowDSL\nStudio's \"Create flow\" → \"From template\" picker. The flowexec module walks the\nregistry at request time, so all you need is to implement one method — no\nextra wiring, no migrations, no HTTP routes.",[997,3530,3532],{"className":1492,"code":3531,"language":1494,"meta":1002,"style":1002},"import (\n    \"encoding\u002Fjson\"\n    _ \"embed\"\n\n    \"github.com\u002Fredelay\u002Fgo-flowdsl\u002Fflowexec\"\n    \"github.com\u002Fredelay\u002Fgo-flowdsl\u002Fir\"\n)\n\n\u002F\u002Fgo:embed flows\u002Fwelcome-email.flowdsl.json\nvar welcomeEmailJSON []byte\n\nfunc (m *Module) Templates() []flowexec.FlowTemplate {\n    var doc ir.Workflow\n    if err := json.Unmarshal(welcomeEmailJSON, &doc); err != nil {\n        m.logger.Warn(\"malformed embedded template\", zap.Error(err))\n        return nil\n    }\n    return []flowexec.FlowTemplate{{\n        \u002F\u002F Conventionally `\u003Cmodule>\u002F\u003Cslug>` so collisions across\n        \u002F\u002F modules are obvious. First-wins on duplicates so a project\n        \u002F\u002F module can override a framework template by reusing the ID.\n        ID:          \"mymodule\u002Fwelcome-email\",\n        Name:        \"User signup → welcome email\",\n        Description: \"Listens for users.user_created and sends a templated welcome email.\",\n        Source:      \"mymodule\",          \u002F\u002F your module name — surfaces as a chip\n        Tags:        []string{\"events\", \"email\", \"onboarding\"},\n        Document:    &doc,                \u002F\u002F full IR workflow — spec form is converted on-demand\n    }}\n}\n",[992,3533,3534,3538,3543,3548,3552,3557,3562,3566,3570,3575,3580,3584,3589,3594,3599,3604,3609,3613,3618,3623,3628,3633,3638,3643,3648,3653,3658,3663,3668],{"__ignoreMap":1002},[1006,3535,3536],{"class":1008,"line":10},[1006,3537,1672],{},[1006,3539,3540],{"class":1008,"line":16},[1006,3541,3542],{},"    \"encoding\u002Fjson\"\n",[1006,3544,3545],{"class":1008,"line":22},[1006,3546,3547],{},"    _ \"embed\"\n",[1006,3549,3550],{"class":1008,"line":51},[1006,3551,1507],{"emptyLinePlaceholder":1506},[1006,3553,3554],{"class":1008,"line":57},[1006,3555,3556],{},"    \"github.com\u002Fredelay\u002Fgo-flowdsl\u002Fflowexec\"\n",[1006,3558,3559],{"class":1008,"line":102},[1006,3560,3561],{},"    \"github.com\u002Fredelay\u002Fgo-flowdsl\u002Fir\"\n",[1006,3563,3564],{"class":1008,"line":108},[1006,3565,1706],{},[1006,3567,3568],{"class":1008,"line":114},[1006,3569,1507],{"emptyLinePlaceholder":1506},[1006,3571,3572],{"class":1008,"line":120},[1006,3573,3574],{},"\u002F\u002Fgo:embed flows\u002Fwelcome-email.flowdsl.json\n",[1006,3576,3577],{"class":1008,"line":181},[1006,3578,3579],{},"var welcomeEmailJSON []byte\n",[1006,3581,3582],{"class":1008,"line":186},[1006,3583,1507],{"emptyLinePlaceholder":1506},[1006,3585,3586],{"class":1008,"line":191},[1006,3587,3588],{},"func (m *Module) Templates() []flowexec.FlowTemplate {\n",[1006,3590,3591],{"class":1008,"line":197},[1006,3592,3593],{},"    var doc ir.Workflow\n",[1006,3595,3596],{"class":1008,"line":203},[1006,3597,3598],{},"    if err := json.Unmarshal(welcomeEmailJSON, &doc); err != nil {\n",[1006,3600,3601],{"class":1008,"line":214},[1006,3602,3603],{},"        m.logger.Warn(\"malformed embedded template\", zap.Error(err))\n",[1006,3605,3606],{"class":1008,"line":223},[1006,3607,3608],{},"        return nil\n",[1006,3610,3611],{"class":1008,"line":229},[1006,3612,1565],{},[1006,3614,3615],{"class":1008,"line":234},[1006,3616,3617],{},"    return []flowexec.FlowTemplate{{\n",[1006,3619,3620],{"class":1008,"line":240},[1006,3621,3622],{},"        \u002F\u002F Conventionally `\u003Cmodule>\u002F\u003Cslug>` so collisions across\n",[1006,3624,3625],{"class":1008,"line":246},[1006,3626,3627],{},"        \u002F\u002F modules are obvious. First-wins on duplicates so a project\n",[1006,3629,3630],{"class":1008,"line":251},[1006,3631,3632],{},"        \u002F\u002F module can override a framework template by reusing the ID.\n",[1006,3634,3635],{"class":1008,"line":257},[1006,3636,3637],{},"        ID:          \"mymodule\u002Fwelcome-email\",\n",[1006,3639,3640],{"class":1008,"line":1766},[1006,3641,3642],{},"        Name:        \"User signup → welcome email\",\n",[1006,3644,3645],{"class":1008,"line":1771},[1006,3646,3647],{},"        Description: \"Listens for users.user_created and sends a templated welcome email.\",\n",[1006,3649,3650],{"class":1008,"line":271},[1006,3651,3652],{},"        Source:      \"mymodule\",          \u002F\u002F your module name — surfaces as a chip\n",[1006,3654,3655],{"class":1008,"line":277},[1006,3656,3657],{},"        Tags:        []string{\"events\", \"email\", \"onboarding\"},\n",[1006,3659,3660],{"class":1008,"line":282},[1006,3661,3662],{},"        Document:    &doc,                \u002F\u002F full IR workflow — spec form is converted on-demand\n",[1006,3664,3665],{"class":1008,"line":1790},[1006,3666,3667],{},"    }}\n",[1006,3669,3670],{"class":1008,"line":1795},[1006,3671,1536],{},[978,3673,3674,3675,3678,3679,3682,3683,3686],{},"The ",[992,3676,3677],{},"Document"," field is an ",[992,3680,3681],{},"*ir.Workflow"," — same shape Redelay uses internally\nfor every flow. Author it as a JSON file, embed it via ",[992,3684,3685],{},"\u002F\u002Fgo:embed",", and\nunmarshal lazily. Keeping the document inline (not in MongoDB) means templates\nare zero-IO to list and survive without a database.",[978,3688,3689,3692,3693,2686],{},[987,3690,3691],{},"Authoring the JSON."," Use the same structure the assistant module ships\n(see ",[992,3694,3695],{},"backend\u002Fmodules\u002Fassistant\u002Fflows\u002Fdefault.flowdsl.json",[997,3697,3701],{"className":3698,"code":3699,"language":3700,"meta":1002,"style":1002},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"id\": \"welcome-email\",\n  \"name\": \"User signup → welcome email\",\n  \"description\": \"...\",\n  \"nodes\": [\n    {\"id\": \"src\",  \"name\": \"On users.user_created\", \"kind\": \"start\",\n     \"action_ref\": \"redelay\u002Fevent-source\",\n     \"config\": {\"eventName\": \"users.user_created\", \"groupID\": \"welcome-email\"}},\n    {\"id\": \"send\", \"name\": \"Send Templated Email\", \"kind\": \"action\",\n     \"action_ref\": \"redelay\u002Femail-send-templated\"},\n    {\"id\": \"end\",  \"name\": \"Sent\",                  \"kind\": \"end\"}\n  ],\n  \"edges\": [\n    {\"id\": \"e1\", \"from\": \"src\",  \"to\": \"send\", \"delivery_mode\": \"durable\"},\n    {\"id\": \"e2\", \"from\": \"send\", \"to\": \"end\",  \"delivery_mode\": \"direct\"}\n  ],\n  \"meta\": {\n    \"positions\": {\n      \"src\":  {\"x\":   0, \"y\": 0},\n      \"send\": {\"x\": 360, \"y\": 0},\n      \"end\":  {\"x\": 720, \"y\": 0}\n    }\n  }\n}\n","json",[992,3702,3703,3708,3732,3752,3772,3786,3844,3865,3916,3970,3990,4045,4050,4063,4136,4206,4210,4224,4238,4281,4318,4355,4359,4364],{"__ignoreMap":1002},[1006,3704,3705],{"class":1008,"line":10},[1006,3706,3707],{"class":3489},"{\n",[1006,3709,3710,3713,3717,3719,3721,3724,3727,3729],{"class":1008,"line":16},[1006,3711,3712],{"class":3489},"  \"",[1006,3714,3716],{"class":3715},"spNyl","id",[1006,3718,3490],{"class":3489},[1006,3720,2403],{"class":3489},[1006,3722,3723],{"class":3489}," \"",[1006,3725,3726],{"class":1015},"welcome-email",[1006,3728,3490],{"class":3489},[1006,3730,3731],{"class":3489},",\n",[1006,3733,3734,3736,3739,3741,3743,3745,3748,3750],{"class":1008,"line":22},[1006,3735,3712],{"class":3489},[1006,3737,3738],{"class":3715},"name",[1006,3740,3490],{"class":3489},[1006,3742,2403],{"class":3489},[1006,3744,3723],{"class":3489},[1006,3746,3747],{"class":1015},"User signup → welcome email",[1006,3749,3490],{"class":3489},[1006,3751,3731],{"class":3489},[1006,3753,3754,3756,3759,3761,3763,3765,3768,3770],{"class":1008,"line":51},[1006,3755,3712],{"class":3489},[1006,3757,3758],{"class":3715},"description",[1006,3760,3490],{"class":3489},[1006,3762,2403],{"class":3489},[1006,3764,3723],{"class":3489},[1006,3766,3767],{"class":1015},"...",[1006,3769,3490],{"class":3489},[1006,3771,3731],{"class":3489},[1006,3773,3774,3776,3779,3781,3783],{"class":1008,"line":57},[1006,3775,3712],{"class":3489},[1006,3777,3778],{"class":3715},"nodes",[1006,3780,3490],{"class":3489},[1006,3782,2403],{"class":3489},[1006,3784,3785],{"class":3489}," [\n",[1006,3787,3788,3791,3793,3795,3797,3799,3801,3804,3806,3809,3811,3813,3815,3817,3819,3822,3824,3826,3828,3831,3833,3835,3837,3840,3842],{"class":1008,"line":102},[1006,3789,3790],{"class":3489},"    {",[1006,3792,3490],{"class":3489},[1006,3794,3716],{"class":1011},[1006,3796,3490],{"class":3489},[1006,3798,2403],{"class":3489},[1006,3800,3723],{"class":3489},[1006,3802,3803],{"class":1015},"src",[1006,3805,3490],{"class":3489},[1006,3807,3808],{"class":3489},",",[1006,3810,3712],{"class":3489},[1006,3812,3738],{"class":1011},[1006,3814,3490],{"class":3489},[1006,3816,2403],{"class":3489},[1006,3818,3723],{"class":3489},[1006,3820,3821],{"class":1015},"On users.user_created",[1006,3823,3490],{"class":3489},[1006,3825,3808],{"class":3489},[1006,3827,3723],{"class":3489},[1006,3829,3830],{"class":1011},"kind",[1006,3832,3490],{"class":3489},[1006,3834,2403],{"class":3489},[1006,3836,3723],{"class":3489},[1006,3838,3839],{"class":1015},"start",[1006,3841,3490],{"class":3489},[1006,3843,3731],{"class":3489},[1006,3845,3846,3849,3852,3854,3856,3858,3861,3863],{"class":1008,"line":108},[1006,3847,3848],{"class":3489},"     \"",[1006,3850,3851],{"class":1011},"action_ref",[1006,3853,3490],{"class":3489},[1006,3855,2403],{"class":3489},[1006,3857,3723],{"class":3489},[1006,3859,3860],{"class":1015},"redelay\u002Fevent-source",[1006,3862,3490],{"class":3489},[1006,3864,3731],{"class":3489},[1006,3866,3867,3869,3872,3874,3876,3879,3881,3885,3887,3889,3891,3894,3896,3898,3900,3903,3905,3907,3909,3911,3913],{"class":1008,"line":114},[1006,3868,3848],{"class":3489},[1006,3870,3871],{"class":1011},"config",[1006,3873,3490],{"class":3489},[1006,3875,2403],{"class":3489},[1006,3877,3878],{"class":3489}," {",[1006,3880,3490],{"class":3489},[1006,3882,3884],{"class":3883},"sbssI","eventName",[1006,3886,3490],{"class":3489},[1006,3888,2403],{"class":3489},[1006,3890,3723],{"class":3489},[1006,3892,3893],{"class":1015},"users.user_created",[1006,3895,3490],{"class":3489},[1006,3897,3808],{"class":3489},[1006,3899,3723],{"class":3489},[1006,3901,3902],{"class":3883},"groupID",[1006,3904,3490],{"class":3489},[1006,3906,2403],{"class":3489},[1006,3908,3723],{"class":3489},[1006,3910,3726],{"class":1015},[1006,3912,3490],{"class":3489},[1006,3914,3915],{"class":3489},"}},\n",[1006,3917,3918,3920,3922,3924,3926,3928,3930,3933,3935,3937,3939,3941,3943,3945,3947,3949,3951,3953,3955,3957,3959,3961,3963,3966,3968],{"class":1008,"line":120},[1006,3919,3790],{"class":3489},[1006,3921,3490],{"class":3489},[1006,3923,3716],{"class":1011},[1006,3925,3490],{"class":3489},[1006,3927,2403],{"class":3489},[1006,3929,3723],{"class":3489},[1006,3931,3932],{"class":1015},"send",[1006,3934,3490],{"class":3489},[1006,3936,3808],{"class":3489},[1006,3938,3723],{"class":3489},[1006,3940,3738],{"class":1011},[1006,3942,3490],{"class":3489},[1006,3944,2403],{"class":3489},[1006,3946,3723],{"class":3489},[1006,3948,638],{"class":1015},[1006,3950,3490],{"class":3489},[1006,3952,3808],{"class":3489},[1006,3954,3723],{"class":3489},[1006,3956,3830],{"class":1011},[1006,3958,3490],{"class":3489},[1006,3960,2403],{"class":3489},[1006,3962,3723],{"class":3489},[1006,3964,3965],{"class":1015},"action",[1006,3967,3490],{"class":3489},[1006,3969,3731],{"class":3489},[1006,3971,3972,3974,3976,3978,3980,3982,3985,3987],{"class":1008,"line":181},[1006,3973,3848],{"class":3489},[1006,3975,3851],{"class":1011},[1006,3977,3490],{"class":3489},[1006,3979,2403],{"class":3489},[1006,3981,3723],{"class":3489},[1006,3983,3984],{"class":1015},"redelay\u002Femail-send-templated",[1006,3986,3490],{"class":3489},[1006,3988,3989],{"class":3489},"},\n",[1006,3991,3992,3994,3996,3998,4000,4002,4004,4007,4009,4011,4013,4015,4017,4019,4021,4024,4026,4028,4031,4033,4035,4037,4039,4041,4043],{"class":1008,"line":186},[1006,3993,3790],{"class":3489},[1006,3995,3490],{"class":3489},[1006,3997,3716],{"class":1011},[1006,3999,3490],{"class":3489},[1006,4001,2403],{"class":3489},[1006,4003,3723],{"class":3489},[1006,4005,4006],{"class":1015},"end",[1006,4008,3490],{"class":3489},[1006,4010,3808],{"class":3489},[1006,4012,3712],{"class":3489},[1006,4014,3738],{"class":1011},[1006,4016,3490],{"class":3489},[1006,4018,2403],{"class":3489},[1006,4020,3723],{"class":3489},[1006,4022,4023],{"class":1015},"Sent",[1006,4025,3490],{"class":3489},[1006,4027,3808],{"class":3489},[1006,4029,4030],{"class":3489},"                  \"",[1006,4032,3830],{"class":1011},[1006,4034,3490],{"class":3489},[1006,4036,2403],{"class":3489},[1006,4038,3723],{"class":3489},[1006,4040,4006],{"class":1015},[1006,4042,3490],{"class":3489},[1006,4044,1536],{"class":3489},[1006,4046,4047],{"class":1008,"line":191},[1006,4048,4049],{"class":3489},"  ],\n",[1006,4051,4052,4054,4057,4059,4061],{"class":1008,"line":197},[1006,4053,3712],{"class":3489},[1006,4055,4056],{"class":3715},"edges",[1006,4058,3490],{"class":3489},[1006,4060,2403],{"class":3489},[1006,4062,3785],{"class":3489},[1006,4064,4065,4067,4069,4071,4073,4075,4077,4080,4082,4084,4086,4089,4091,4093,4095,4097,4099,4101,4103,4106,4108,4110,4112,4114,4116,4118,4120,4123,4125,4127,4129,4132,4134],{"class":1008,"line":203},[1006,4066,3790],{"class":3489},[1006,4068,3490],{"class":3489},[1006,4070,3716],{"class":1011},[1006,4072,3490],{"class":3489},[1006,4074,2403],{"class":3489},[1006,4076,3723],{"class":3489},[1006,4078,4079],{"class":1015},"e1",[1006,4081,3490],{"class":3489},[1006,4083,3808],{"class":3489},[1006,4085,3723],{"class":3489},[1006,4087,4088],{"class":1011},"from",[1006,4090,3490],{"class":3489},[1006,4092,2403],{"class":3489},[1006,4094,3723],{"class":3489},[1006,4096,3803],{"class":1015},[1006,4098,3490],{"class":3489},[1006,4100,3808],{"class":3489},[1006,4102,3712],{"class":3489},[1006,4104,4105],{"class":1011},"to",[1006,4107,3490],{"class":3489},[1006,4109,2403],{"class":3489},[1006,4111,3723],{"class":3489},[1006,4113,3932],{"class":1015},[1006,4115,3490],{"class":3489},[1006,4117,3808],{"class":3489},[1006,4119,3723],{"class":3489},[1006,4121,4122],{"class":1011},"delivery_mode",[1006,4124,3490],{"class":3489},[1006,4126,2403],{"class":3489},[1006,4128,3723],{"class":3489},[1006,4130,4131],{"class":1015},"durable",[1006,4133,3490],{"class":3489},[1006,4135,3989],{"class":3489},[1006,4137,4138,4140,4142,4144,4146,4148,4150,4153,4155,4157,4159,4161,4163,4165,4167,4169,4171,4173,4175,4177,4179,4181,4183,4185,4187,4189,4191,4193,4195,4197,4199,4202,4204],{"class":1008,"line":214},[1006,4139,3790],{"class":3489},[1006,4141,3490],{"class":3489},[1006,4143,3716],{"class":1011},[1006,4145,3490],{"class":3489},[1006,4147,2403],{"class":3489},[1006,4149,3723],{"class":3489},[1006,4151,4152],{"class":1015},"e2",[1006,4154,3490],{"class":3489},[1006,4156,3808],{"class":3489},[1006,4158,3723],{"class":3489},[1006,4160,4088],{"class":1011},[1006,4162,3490],{"class":3489},[1006,4164,2403],{"class":3489},[1006,4166,3723],{"class":3489},[1006,4168,3932],{"class":1015},[1006,4170,3490],{"class":3489},[1006,4172,3808],{"class":3489},[1006,4174,3723],{"class":3489},[1006,4176,4105],{"class":1011},[1006,4178,3490],{"class":3489},[1006,4180,2403],{"class":3489},[1006,4182,3723],{"class":3489},[1006,4184,4006],{"class":1015},[1006,4186,3490],{"class":3489},[1006,4188,3808],{"class":3489},[1006,4190,3712],{"class":3489},[1006,4192,4122],{"class":1011},[1006,4194,3490],{"class":3489},[1006,4196,2403],{"class":3489},[1006,4198,3723],{"class":3489},[1006,4200,4201],{"class":1015},"direct",[1006,4203,3490],{"class":3489},[1006,4205,1536],{"class":3489},[1006,4207,4208],{"class":1008,"line":223},[1006,4209,4049],{"class":3489},[1006,4211,4212,4214,4217,4219,4221],{"class":1008,"line":229},[1006,4213,3712],{"class":3489},[1006,4215,4216],{"class":3715},"meta",[1006,4218,3490],{"class":3489},[1006,4220,2403],{"class":3489},[1006,4222,4223],{"class":3489}," {\n",[1006,4225,4226,4229,4232,4234,4236],{"class":1008,"line":234},[1006,4227,4228],{"class":3489},"    \"",[1006,4230,4231],{"class":1011},"positions",[1006,4233,3490],{"class":3489},[1006,4235,2403],{"class":3489},[1006,4237,4223],{"class":3489},[1006,4239,4240,4243,4245,4247,4249,4252,4254,4258,4260,4262,4265,4267,4269,4272,4274,4276,4279],{"class":1008,"line":240},[1006,4241,4242],{"class":3489},"      \"",[1006,4244,3803],{"class":3883},[1006,4246,3490],{"class":3489},[1006,4248,2403],{"class":3489},[1006,4250,4251],{"class":3489},"  {",[1006,4253,3490],{"class":3489},[1006,4255,4257],{"class":4256},"swJcz","x",[1006,4259,3490],{"class":3489},[1006,4261,2403],{"class":3489},[1006,4263,4264],{"class":3883},"   0",[1006,4266,3808],{"class":3489},[1006,4268,3723],{"class":3489},[1006,4270,4271],{"class":4256},"y",[1006,4273,3490],{"class":3489},[1006,4275,2403],{"class":3489},[1006,4277,4278],{"class":3883}," 0",[1006,4280,3989],{"class":3489},[1006,4282,4283,4285,4287,4289,4291,4293,4295,4297,4299,4301,4304,4306,4308,4310,4312,4314,4316],{"class":1008,"line":246},[1006,4284,4242],{"class":3489},[1006,4286,3932],{"class":3883},[1006,4288,3490],{"class":3489},[1006,4290,2403],{"class":3489},[1006,4292,3878],{"class":3489},[1006,4294,3490],{"class":3489},[1006,4296,4257],{"class":4256},[1006,4298,3490],{"class":3489},[1006,4300,2403],{"class":3489},[1006,4302,4303],{"class":3883}," 360",[1006,4305,3808],{"class":3489},[1006,4307,3723],{"class":3489},[1006,4309,4271],{"class":4256},[1006,4311,3490],{"class":3489},[1006,4313,2403],{"class":3489},[1006,4315,4278],{"class":3883},[1006,4317,3989],{"class":3489},[1006,4319,4320,4322,4324,4326,4328,4330,4332,4334,4336,4338,4341,4343,4345,4347,4349,4351,4353],{"class":1008,"line":251},[1006,4321,4242],{"class":3489},[1006,4323,4006],{"class":3883},[1006,4325,3490],{"class":3489},[1006,4327,2403],{"class":3489},[1006,4329,4251],{"class":3489},[1006,4331,3490],{"class":3489},[1006,4333,4257],{"class":4256},[1006,4335,3490],{"class":3489},[1006,4337,2403],{"class":3489},[1006,4339,4340],{"class":3883}," 720",[1006,4342,3808],{"class":3489},[1006,4344,3723],{"class":3489},[1006,4346,4271],{"class":4256},[1006,4348,3490],{"class":3489},[1006,4350,2403],{"class":3489},[1006,4352,4278],{"class":3883},[1006,4354,1536],{"class":3489},[1006,4356,4357],{"class":1008,"line":257},[1006,4358,1565],{"class":3489},[1006,4360,4361],{"class":1008,"line":1766},[1006,4362,4363],{"class":3489},"  }\n",[1006,4365,4366],{"class":1008,"line":1771},[1006,4367,1536],{"class":3489},[978,4369,4370],{},[987,4371,4372],{},"Rules of thumb:",[1109,4374,4375,4393,4402,4412],{},[1112,4376,4377,4378,4380,4381,4384,4385,4388,4389,4392],{},"Every ",[992,4379,3851],{}," must match an ",[992,4382,4383],{},"id:"," from a real ",[992,4386,4387],{},"flowdsl_nodes"," entry.\nOpen ",[992,4390,4391],{},"\u002Fmodules"," after boot to see what's registered.",[1112,4394,4377,4395,4397,4398,4401],{},[992,4396,3871],{}," key must match the node's ",[992,4399,4400],{},"settings_schema.properties"," —\nunknown keys are accepted by the JSON parser but ignored at runtime.",[1112,4403,4404,4405,4408,4409,4411],{},"Drop the optional ",[992,4406,4407],{},"packet"," field on edges unless the value's ",[992,4410,2241],{},"\nexactly matches one of the connected port schemas. Mismatches surface as\nvalidation warnings in the Studio canvas.",[1112,4413,4414,4415,4418],{},"Add ",[992,4416,4417],{},"meta.positions"," for every node so the canvas renders something\nsensible — without positions, every node stacks on the origin.",[978,4420,4421,4422,4425],{},"The Studio fetches the lightweight metadata (id, name, description, source,\ntags) up-front for the picker grid; the full document is only fetched when\nthe user clicks ",[987,4423,4424],{},"Create from template",". Keep individual templates small\nand focused — five tight starters beat one sprawling kitchen-sink flow.",[978,4427,4428,4429,4437],{},"For a full library example, see ",[1066,4430,4434],{"href":4431,"rel":4432},"https:\u002F\u002Fgithub.com\u002Fredelay\u002Fgo-modules\u002Ftree\u002Fmain\u002Fflowtemplates",[4433],"nofollow",[992,4435,4436],{},"go-modules\u002Fflowtemplates"," — five\nproduction-shaped starters covering events→DB, scheduled API polling,\nDB→LLM→alert, welcome email, and failed-login burst alerts.",[1070,4439,4441],{"id":4440},"checklist","Checklist",[1109,4443,4446,4457,4468,4478,4489,4507,4513,4521,4534,4546,4562],{"className":4444},[4445],"contains-task-list",[1112,4447,4450,1104,4454,4456],{"className":4448},[4449],"task-list-item",[4451,4452],"input",{"disabled":1506,"type":4453},"checkbox",[992,4455,994],{}," — Module definition (optional but recommended for validation + diagrams)",[1112,4458,4460,1104,4462,4464,4465,4467],{"className":4459},[4449],[4451,4461],{"disabled":1506,"type":4453},[992,4463,1223],{}," — Config struct + ",[992,4466,1231],{}," with env prefix",[1112,4469,4471,1104,4473,4475,4476],{"className":4470},[4449],[4451,4472],{"disabled":1506,"type":4453},[992,4474,1261],{}," — MongoDB models with ",[992,4477,1591],{},[1112,4479,4481,1104,4483,4485,4486],{"className":4480},[4449],[4451,4482],{"disabled":1506,"type":4453},[992,4484,1125],{}," — Business logic + ",[992,4487,4488],{},"EnsureIndexes()",[1112,4490,4492,1104,4494,2662,4496,4498,4499,1207,4502,4504,4505],{"className":4491},[4449],[4451,4493],{"disabled":1506,"type":4453},[992,4495,1041],{},[992,4497,1173],{}," with ",[992,4500,4501],{},"RegisterFactory",[992,4503,1177],{}," implementing ",[992,4506,1847],{},[1112,4508,4510,4512],{"className":4509},[4449],[4451,4511],{"disabled":1506,"type":4453}," Blank import in your app's main package",[1112,4514,4516,1104,4518,4520],{"className":4515},[4449],[4451,4517],{"disabled":1506,"type":4453},[992,4519,3213],{}," set if you rely on other modules",[1112,4522,4524,4526,4527,4498,4529,4531,4532],{"className":4523},[4449],[4451,4525],{"disabled":1506,"type":4453}," If using events: ",[992,4528,1133],{},[992,4530,1350],{},", implement ",[992,4533,2171],{},[1112,4535,4537,4539,4540,4542,4543,4545],{"className":4536},[4449],[4451,4538],{"disabled":1506,"type":4453}," If contributing CLI commands: implement ",[992,4541,2201],{},", create ",[992,4544,3380],{}," entry point",[1112,4547,4549,4551,4552,4554,4555,4558,4559,1251],{"className":4548},[4449],[4451,4550],{"disabled":1506,"type":4453}," If shipping starter flows: implement ",[992,4553,2259],{},", embed ",[992,4556,4557],{},"flows\u002F*.json"," (see ",[1066,4560,4561],{"href":232},"reference",[1112,4563,4565,1104,4567,4570],{"className":4564},[4449],[4451,4566],{"disabled":1506,"type":4453},[992,4568,4569],{},"redelayctl validate-module module.yaml"," — passes with no errors",[1070,4572,4574],{"id":4573},"clickhouse-modules","ClickHouse modules",[978,4576,4577,4578,4581,4582,4585,4586,4589,4590,4593,4594,4597],{},"For analytics-oriented modules, use ",[992,4579,4580],{},"crud.ClickHouseCRUD[T]"," instead of ",[992,4583,4584],{},"MongoCRUD",". Models implement\n",[992,4587,4588],{},"ClickHouseModel"," (requires ",[992,4591,4592],{},"TableName() string",") and use ",[992,4595,4596],{},"ch"," struct tags for column mapping:",[997,4599,4601],{"className":1492,"code":4600,"language":1494,"meta":1002,"style":1002},"type PageView struct {\n    Timestamp time.Time `ch:\"timestamp\"`\n    Domain    string    `ch:\"domain\"`\n    Count     uint64    `ch:\"count\"`\n}\n\nfunc (p *PageView) TableName() string { return \"page_views\" }\n",[992,4602,4603,4608,4613,4618,4623,4627,4631],{"__ignoreMap":1002},[1006,4604,4605],{"class":1008,"line":10},[1006,4606,4607],{},"type PageView struct {\n",[1006,4609,4610],{"class":1008,"line":16},[1006,4611,4612],{},"    Timestamp time.Time `ch:\"timestamp\"`\n",[1006,4614,4615],{"class":1008,"line":22},[1006,4616,4617],{},"    Domain    string    `ch:\"domain\"`\n",[1006,4619,4620],{"class":1008,"line":51},[1006,4621,4622],{},"    Count     uint64    `ch:\"count\"`\n",[1006,4624,4625],{"class":1008,"line":57},[1006,4626,1536],{},[1006,4628,4629],{"class":1008,"line":102},[1006,4630,1507],{"emptyLinePlaceholder":1506},[1006,4632,4633],{"class":1008,"line":108},[1006,4634,4635],{},"func (p *PageView) TableName() string { return \"page_views\" }\n",[978,4637,4638],{},"For high-throughput writes, wrap with a batch writer:",[997,4640,4642],{"className":1492,"code":4641,"language":1494,"meta":1002,"style":1002},"writer := crud.BatchWriterFor(chCrud,\n    crud.WithBatchSize(500),\n    crud.WithFlushInterval(5 * time.Second),\n)\nwriter.Enqueue(&PageView{...}) \u002F\u002F non-blocking\ndefer writer.Stop()            \u002F\u002F drains remaining items\n",[992,4643,4644,4649,4654,4659,4663,4668],{"__ignoreMap":1002},[1006,4645,4646],{"class":1008,"line":10},[1006,4647,4648],{},"writer := crud.BatchWriterFor(chCrud,\n",[1006,4650,4651],{"class":1008,"line":16},[1006,4652,4653],{},"    crud.WithBatchSize(500),\n",[1006,4655,4656],{"class":1008,"line":22},[1006,4657,4658],{},"    crud.WithFlushInterval(5 * time.Second),\n",[1006,4660,4661],{"class":1008,"line":51},[1006,4662,1706],{},[1006,4664,4665],{"class":1008,"line":57},[1006,4666,4667],{},"writer.Enqueue(&PageView{...}) \u002F\u002F non-blocking\n",[1006,4669,4670],{"class":1008,"line":102},[1006,4671,4672],{},"defer writer.Stop()            \u002F\u002F drains remaining items\n",[978,4674,4675,4676,4679],{},"See the ",[1066,4677,4678],{"href":136},"go-framework reference"," for the full ClickHouse CRUD and batch writer API.",[4681,4682,4683],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":1002,"searchDepth":16,"depth":16,"links":4685},[4686,4690,4692,4694,4696,4698,4699,4714,4715],{"id":1072,"depth":16,"text":1073,"children":4687},[4688],{"id":1412,"depth":22,"text":4689},"Submodules (flowdsl\u002F, admin\u002F)",{"id":1477,"depth":16,"text":4691},"Step 1: Create config.go",{"id":1582,"depth":16,"text":4693},"Step 2: Create model.go",{"id":1641,"depth":16,"text":4695},"Step 3: Create service.go",{"id":1829,"depth":16,"text":4697},"Step 4: Create module.go",{"id":2082,"depth":16,"text":2083},{"id":2133,"depth":16,"text":2134,"children":4700},[4701,4702,4704,4706,4708,4710,4712],{"id":2305,"depth":22,"text":2306},{"id":2375,"depth":22,"text":4703},"Example: Publishing Schemas Without Routes (SchemasProvider)",{"id":2490,"depth":22,"text":4705},"Example: Exposing MCP Tools (MCPProvider)",{"id":2646,"depth":22,"text":4707},"Example: Publishing and Consuming Events (EventsProvider)",{"id":3157,"depth":22,"text":4709},"Example: Cross-Module Dependencies (Configurable)",{"id":3248,"depth":22,"text":4711},"Example: Contributing CLI Commands (CLIProvider)",{"id":3518,"depth":22,"text":4713},"Example: Contributing Flow Templates (TemplateProvider)",{"id":4440,"depth":16,"text":4441},{"id":4573,"depth":16,"text":4574},"Step-by-step guide to creating a new module for the redelay go-framework.","md",null,{},{"order":16,"icon":46},{"title":82,"description":4716},"4f5USEJ0jvXHzGIljae-7Ys5Jxj0vxGhqybaWJUbDEg",[4724,4726],{"title":78,"path":79,"stem":80,"description":4725,"icon":17,"children":-1},"Ship a Redelay Go backend to Docker Swarm — a Mode B image built with SSH-forwarded private modules, a swarm stack that survives node reboots, and a push-to-deploy GitHub Actions workflow that fails on an automatic rollback.",{"title":86,"path":87,"stem":88,"description":4727,"order":22,"icon":36,"children":-1},"How to publish events, consume events, and test event-driven behaviour in a Redelay Go module.",1790332226867]