@synergenius/flow-weaver 0.10.7 → 0.10.9

package/LICENSE

@@ -1,7 +1,44 @@
 Flow Weaver Library License
 
-Based on the Elastic License 2.0 (https://www.elastic.co/licensing/elastic-license)
-with additional notices below.
+Version 2.0, February 2026
+
+## Quick Reference (non-binding summary)
+
+This table is provided for convenience only. In case of any conflict between
+this summary and the license terms below, the license terms control.
+
+Permitted:
+
+  Use                                       Who               Notes
+  ----------------------------------------  ----------------  ----------------------------------
+  Install and run locally                   Anyone            No restrictions on local use
+  Compile workflows                         Anyone            CLI, programmatic, scripts
+  Use generated output (code, artifacts)    Anyone            Output is unrestricted
+  Run in CI/CD pipelines and build systems  Anyone, any size  Not considered "hosting"
+  Distribute copies with license notices    Anyone            Must include license, mark changes
+  Create derivative works                   Anyone            Must retain license key checks
+  Host internally                           Orgs <= 15        All members count toward limit
+  Embed in internal toolchains              Anyone            No visual workflow authoring UI
+  Use inside a larger product                Anyone            If flow-weaver is not the primary value
+
+Requires commercial license:
+
+  Use                                       Notes
+  ----------------------------------------  ----------------------------------
+  Host internally                           Orgs > 15 people
+  Build visual workflow authoring tools     Standalone products for workflow authoring
+  Offer as a hosted or managed service      To third parties, at any scale
+  Sell products built on the software       Where flow-weaver is the primary value
+
+Never permitted:
+
+  Use                                       Notes
+  ----------------------------------------  ----------------------------------
+  Remove or circumvent license keys         Applies to software and derivatives
+  Remove licensing or copyright notices     Must always be retained
+  Strip license key checks from forks       Derivatives must retain protections
+
+---
 
 ## Acceptance
 
@@ -17,13 +54,33 @@ the limitations and conditions below.
 ## Limitations
 
 You may not provide the software to third parties as a hosted or managed
-service, where the service provides users with access to any substantial set of
-the features or functionality of the software.
+service, where the service provides users with access to any of the features or
+functionality of the software.
+
+You may not use the software to build, distribute, or offer any standalone
+product or service whose primary purpose is providing a graphical or visual
+interface for creating, editing, designing, or composing workflows. This
+restriction applies whether the product is hosted, distributed, sold, or offered
+free of charge. It does not apply to products that use the software internally
+without exposing its workflow authoring capabilities to end users through a
+graphical interface.
+
+You may not sell the software or any product that provides, as its primary
+function, capabilities supplied by the software (including workflow compilation,
+parsing, validation, code generation, or diagram generation), without a separate
+commercial license from the licensor. This does not restrict the sale of products
+that merely incorporate the software as one component among many, where the
+product's primary value comes from functionality independent of the software.
 
 You may not move, change, disable, or circumvent the license key functionality
 in the software, and you may not remove or obscure any functionality in the
 software that is protected by the license key.
 
+Derivative works must retain all license key functionality, license verification
+mechanisms, and licensing notices present in the original software. Distributing
+derivative works with license key protections removed, disabled, or bypassed
+constitutes a violation of this license.
+
 You may not alter, remove, or obscure any licensing, copyright, or other notices
 of the licensor in the software. Any use of the licensor's trademarks is subject
 to applicable law.
@@ -61,8 +118,11 @@ and your licenses will automatically terminate. If the licensor provides you
 with a notice of your violation, and you cease all violation of this license no
 later than 30 days after you receive that notice, your licenses will be
 reinstated retroactively. However, if you violate these terms after such
-reinstatement, any additional violation of these terms will immediately and
-permanently terminate your licenses.
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate immediately.
+
+You may request a review of any termination by contacting the licensor in
+writing within 15 days of termination. The licensor will respond within 30 days.
 
 ## No Liability
 
@@ -71,6 +131,12 @@ condition, and the licensor will not be liable to you for any damages arising
 out of these terms or the use or nature of the software, under any kind of
 legal claim.
 
+## Governing Law
+
+This license is governed by the laws of Portugal. Any disputes arising from or
+related to this license will be submitted to the exclusive jurisdiction of the
+courts of Lisbon, Portugal.
+
 ## Definitions
 
 The "licensor" is Ricardo Jose Horta Morais (Synergenius), and the "software"
@@ -84,40 +150,55 @@ ownership of substantially all the assets of an entity, or the power to direct
 its management and policies by vote, contract, or otherwise. Control can be
 direct or indirect.
 
+"Third parties" means any individual or entity that is not you or your company
+as defined in these terms.
+
 "Your licenses" are all the licenses granted to you for the software under these
 terms. "Use" means anything you do with the software requiring one of your
 licenses.
 
+"Hosting the software" means making the software's functionality available to
+users over a network as a service. Running the software in automated build
+pipelines, continuous integration systems, command-line interfaces, or
+development toolchains does not constitute hosting, regardless of organization
+size.
+
 ---
 
 ADDITIONAL NOTICES
 
 1. Output of the Software
 
-The output of the Software — including but not limited to compiled workflows,
+The output of the software, including but not limited to compiled workflows,
 generated code, deployment artifacts, and any other files produced by the
-Software's compilation, code generation, or export features — is not considered
-part of the Software and may be used, copied, modified, distributed, and
-sublicensed for any purpose without restriction under this License.
+software's compilation, code generation, or export features, is not considered
+part of the software and may be used, copied, modified, distributed, and
+sublicensed for any purpose without restriction under this license.
 
 2. Internal Hosting Threshold
 
-Organizations with 15 or fewer individuals — including employees, contractors,
-and affiliates — may host the Software on internal infrastructure for use by
-their members without restriction under this License.
+Organizations with 15 or fewer individuals, including employees, contractors,
+and affiliates, may host the software on internal infrastructure for use by
+their members without restriction under this license. The count includes all
+individuals in the organization, not only those who directly use the software.
 
-Organizations with more than 15 individuals that wish to host the Software —
-whether on internal infrastructure or as a service — require a commercial
+Organizations with more than 15 individuals that wish to host the software,
+whether on internal infrastructure or as a service, require a commercial
 license.
 
 3. Unrestricted Use
 
-Using the Software locally — including installing, running, compiling
-workflows, generating code, and producing deployment artifacts — is permitted
-for any individual or organization regardless of size, subject to the
-Limitations above.
+Using the software locally, including installing, running, compiling workflows,
+generating code, and producing deployment artifacts, is permitted for any
+individual or organization regardless of size, subject to the Limitations above.
+
+4. Export Compliance
+
+You are responsible for compliance with all applicable export and import laws
+and regulations in your jurisdiction when using, distributing, or making the
+software available.
 
-4. Commercial Licensing
+5. Commercial Licensing
 
 For commercial licensing inquiries, partnership arrangements, or questions
 about permitted use, contact support@synergenius.pt.

package/dist/cli/commands/describe.d.ts

@@ -3,7 +3,7 @@
  */
 import type { TWorkflowAST, TNodeInstanceAST, TNodeTypeAST } from '../../ast/types.js';
 export interface DescribeOptions {
-    format?: 'json' | 'text' | 'mermaid' | 'paths';
+    format?: 'json' | 'text' | 'mermaid' | 'paths' | 'ascii' | 'ascii-compact';
     node?: string;
     workflowName?: string;
     compile?: boolean;
@@ -63,6 +63,6 @@ export declare function formatTextOutput(ast: TWorkflowAST, output: DescribeOutp
 /**
  * Format the describe output based on format option
  */
-export declare function formatDescribeOutput(ast: TWorkflowAST, output: DescribeOutput | FocusedNodeOutput, format: 'json' | 'text' | 'mermaid' | 'paths'): string;
+export declare function formatDescribeOutput(ast: TWorkflowAST, output: DescribeOutput | FocusedNodeOutput, format: 'json' | 'text' | 'mermaid' | 'paths' | 'ascii' | 'ascii-compact'): string;
 export declare function describeCommand(input: string, options?: DescribeOptions): Promise<void>;
 //# sourceMappingURL=describe.d.ts.map

package/dist/cli/commands/describe.js

@@ -9,6 +9,8 @@ import { validator } from '../../validator.js';
 import { getNode, getIncomingConnections, getOutgoingConnections } from '../../api/query.js';
 import { logger } from '../utils/logger.js';
 import { getErrorMessage } from '../../utils/error-utils.js';
+import { buildDiagramGraph } from '../../diagram/geometry.js';
+import { renderASCII, renderASCIICompact } from '../../diagram/ascii-renderer.js';
 export function buildNodeInfo(instance, nodeType) {
     return {
         id: instance.id,
@@ -329,6 +331,10 @@ export function formatDescribeOutput(ast, output, format) {
             return generateMermaid(ast);
         case 'paths':
             return formatPaths(ast);
+        case 'ascii':
+            return renderASCII(buildDiagramGraph(ast));
+        case 'ascii-compact':
+            return renderASCIICompact(buildDiagramGraph(ast));
         case 'json':
         default:
             return JSON.stringify(output, null, 2);

package/dist/cli/commands/diagram.d.ts

@@ -1,5 +1,5 @@
 /**
- * Diagram command — generates SVG or interactive HTML diagrams from workflow files.
+ * Diagram command — generates SVG, interactive HTML, or ASCII diagrams from workflow files.
  */
 export interface DiagramCommandOptions {
     theme?: 'dark' | 'light';
@@ -8,7 +8,7 @@ export interface DiagramCommandOptions {
     showPortLabels?: boolean;
     workflowName?: string;
     output?: string;
-    format?: 'svg' | 'html';
+    format?: 'svg' | 'html' | 'ascii' | 'ascii-compact' | 'text';
 }
 export declare function diagramCommand(input: string, options?: DiagramCommandOptions): Promise<void>;
 //# sourceMappingURL=diagram.d.ts.map

package/dist/cli/commands/diagram.js

@@ -1,12 +1,13 @@
 /* eslint-disable no-console */
 /**
- * Diagram command — generates SVG or interactive HTML diagrams from workflow files.
+ * Diagram command — generates SVG, interactive HTML, or ASCII diagrams from workflow files.
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import { fileToSVG, fileToHTML } from '../../diagram/index.js';
+import { fileToSVG, fileToHTML, fileToASCII } from '../../diagram/index.js';
 import { logger } from '../utils/logger.js';
 import { getErrorMessage } from '../../utils/error-utils.js';
+const ASCII_FORMATS = new Set(['ascii', 'ascii-compact', 'text']);
 export async function diagramCommand(input, options = {}) {
     const { output, format = 'svg', ...diagramOptions } = options;
     const filePath = path.resolve(input);
@@ -15,10 +16,16 @@ export async function diagramCommand(input, options = {}) {
         process.exit(1);
     }
     try {
-        const isHtml = format === 'html';
-        const result = isHtml
-            ? fileToHTML(filePath, diagramOptions)
-            : fileToSVG(filePath, diagramOptions);
+        let result;
+        if (ASCII_FORMATS.has(format)) {
+            result = fileToASCII(filePath, { ...diagramOptions, format });
+        }
+        else if (format === 'html') {
+            result = fileToHTML(filePath, diagramOptions);
+        }
+        else {
+            result = fileToSVG(filePath, diagramOptions);
+        }
         if (output) {
             const outputPath = path.resolve(output);
             fs.writeFileSync(outputPath, result, 'utf-8');