@synergenius/flow-weaver 0.17.9 → 0.17.10

package/dist/chevrotain-parser/port-parser.d.ts

@@ -15,6 +15,7 @@ export interface PortParseResult {
     mergeStrategy?: string;
     hidden?: boolean;
     description?: string;
+    customMetadata?: Record<string, string | boolean | number>;
 }
 /**
  * Parse a port line (@input/@output/@step) and return structured result.

package/dist/chevrotain-parser/port-parser.js

@@ -98,6 +98,7 @@ class PortParser extends CstParser {
                     { ALT: () => this.SUBRULE(this.typeAttr) },
                     { ALT: () => this.SUBRULE(this.mergeStrategyAttr) },
                     { ALT: () => this.SUBRULE(this.hiddenAttr) },
+                    { ALT: () => this.SUBRULE(this.customAttr) },
                 ]);
             },
         });
@@ -131,6 +132,18 @@ class PortParser extends CstParser {
     hiddenAttr = this.RULE('hiddenAttr', () => {
         this.CONSUME(HiddenKeyword);
     });
+    // customAttr: key:value pairs for arbitrary metadata (e.g., artifactPath:"dist/")
+    customAttr = this.RULE('customAttr', () => {
+        this.CONSUME(Identifier, { LABEL: 'customKey' });
+        this.CONSUME(Colon);
+        this.OR([
+            { ALT: () => this.CONSUME(StringLiteral, { LABEL: 'customStrVal' }) },
+            { ALT: () => this.CONSUME(TrueKeyword, { LABEL: 'customTrue' }) },
+            { ALT: () => this.CONSUME(FalseKeyword, { LABEL: 'customFalse' }) },
+            { ALT: () => this.CONSUME2(Identifier, { LABEL: 'customIdVal' }) },
+            { ALT: () => this.CONSUME(Integer, { LABEL: 'customIntVal' }) },
+        ]);
+    });
     // - description text
     // Note: We just consume the dash here. The actual description text is extracted
     // from the raw input in parsePortLine() to handle special characters like &, :, etc.
@@ -232,6 +245,7 @@ class PortVisitor extends BaseVisitor {
             scope = this.visit(ctx.scopeClause);
         }
         let hidden;
+        let customMetadata;
         if (ctx.metadataBracket) {
             // Handle multiple metadata brackets (e.g., [order:1] [placement:TOP])
             for (const bracket of ctx.metadataBracket) {
@@ -246,6 +260,9 @@ class PortVisitor extends BaseVisitor {
                     mergeStrategy = metadata.mergeStrategy;
                 if (metadata.hidden)
                     hidden = true;
+                if (metadata.customMetadata) {
+                    customMetadata = { ...customMetadata, ...metadata.customMetadata };
+                }
             }
         }
         if (ctx.descriptionClause) {
@@ -263,6 +280,7 @@ class PortVisitor extends BaseVisitor {
             ...(mergeStrategy && { mergeStrategy }),
             ...(hidden && { hidden }),
             ...(description && { description }),
+            ...(customMetadata && { customMetadata }),
         };
     }
     outputPort(ctx) {
@@ -276,6 +294,7 @@ class PortVisitor extends BaseVisitor {
             scope = this.visit(ctx.scopeClause);
         }
         let hidden;
+        let customMetadata;
         if (ctx.metadataBracket) {
             // Handle multiple metadata brackets (e.g., [order:1] [placement:TOP])
             for (const bracket of ctx.metadataBracket) {
@@ -288,6 +307,9 @@ class PortVisitor extends BaseVisitor {
                     dataType = metadata.dataType;
                 if (metadata.hidden)
                     hidden = true;
+                if (metadata.customMetadata) {
+                    customMetadata = { ...customMetadata, ...metadata.customMetadata };
+                }
             }
         }
         if (ctx.descriptionClause) {
@@ -302,6 +324,7 @@ class PortVisitor extends BaseVisitor {
             ...(dataType && { dataType }),
             ...(hidden && { hidden }),
             ...(description && { description }),
+            ...(customMetadata && { customMetadata }),
         };
     }
     stepPort(ctx) {
@@ -325,6 +348,7 @@ class PortVisitor extends BaseVisitor {
         let dataType;
         let mergeStrategy;
         let hidden;
+        let customMetadata;
         if (ctx.orderAttr) {
             for (const attr of ctx.orderAttr) {
                 order = this.visit(attr);
@@ -348,7 +372,14 @@ class PortVisitor extends BaseVisitor {
         if (ctx.hiddenAttr) {
             hidden = true;
         }
-        return { order, placement, dataType, mergeStrategy, hidden };
+        if (ctx.customAttr) {
+            customMetadata = customMetadata || {};
+            for (const attr of ctx.customAttr) {
+                const { key, value } = this.visit(attr);
+                customMetadata[key] = value;
+            }
+        }
+        return { order, placement, dataType, mergeStrategy, hidden, customMetadata };
     }
     orderAttr(ctx) {
         return parseInt(ctx.orderValue[0].image, 10);
@@ -365,6 +396,31 @@ class PortVisitor extends BaseVisitor {
     mergeStrategyAttr(ctx) {
         return ctx.mergeStrategyValue[0].image;
     }
+    customAttr(ctx) {
+        const key = ctx.customKey[0].image;
+        let value;
+        if (ctx.customStrVal) {
+            // Remove quotes from string literal
+            const raw = ctx.customStrVal[0].image;
+            value = raw.slice(1, -1);
+        }
+        else if (ctx.customTrue) {
+            value = true;
+        }
+        else if (ctx.customFalse) {
+            value = false;
+        }
+        else if (ctx.customIntVal) {
+            value = parseInt(ctx.customIntVal[0].image, 10);
+        }
+        else if (ctx.customIdVal) {
+            value = ctx.customIdVal[0].image;
+        }
+        else {
+            value = '';
+        }
+        return { key, value };
+    }
     descriptionClause(ctx) {
         if (ctx.Identifier) {
             return ctx.Identifier.map((token) => token.image).join(' ');

package/dist/cli/flow-weaver.mjs

@@ -9671,7 +9671,7 @@ var VERSION;
 var init_generated_version = __esm({
   "src/generated-version.ts"() {
     "use strict";
-    VERSION = "0.17.9";
+    VERSION = "0.17.10";
   }
 });
 
@@ -31902,7 +31902,8 @@ var init_port_parser = __esm({
               { ALT: () => this.SUBRULE(this.placementAttr) },
               { ALT: () => this.SUBRULE(this.typeAttr) },
               { ALT: () => this.SUBRULE(this.mergeStrategyAttr) },
-              { ALT: () => this.SUBRULE(this.hiddenAttr) }
+              { ALT: () => this.SUBRULE(this.hiddenAttr) },
+              { ALT: () => this.SUBRULE(this.customAttr) }
             ]);
           }
         });
@@ -31936,6 +31937,18 @@ var init_port_parser = __esm({
       hiddenAttr = this.RULE("hiddenAttr", () => {
         this.CONSUME(HiddenKeyword);
       });
+      // customAttr: key:value pairs for arbitrary metadata (e.g., artifactPath:"dist/")
+      customAttr = this.RULE("customAttr", () => {
+        this.CONSUME(Identifier, { LABEL: "customKey" });
+        this.CONSUME(Colon);
+        this.OR([
+          { ALT: () => this.CONSUME(StringLiteral, { LABEL: "customStrVal" }) },
+          { ALT: () => this.CONSUME(TrueKeyword, { LABEL: "customTrue" }) },
+          { ALT: () => this.CONSUME(FalseKeyword, { LABEL: "customFalse" }) },
+          { ALT: () => this.CONSUME2(Identifier, { LABEL: "customIdVal" }) },
+          { ALT: () => this.CONSUME(Integer, { LABEL: "customIntVal" }) }
+        ]);
+      });
       // - description text
       // Note: We just consume the dash here. The actual description text is extracted
       // from the raw input in parsePortLine() to handle special characters like &, :, etc.
@@ -32022,6 +32035,7 @@ var init_port_parser = __esm({
           scope = this.visit(ctx.scopeClause);
         }
         let hidden;
+        let customMetadata;
         if (ctx.metadataBracket) {
           for (const bracket of ctx.metadataBracket) {
             const metadata = this.visit(bracket);
@@ -32030,6 +32044,9 @@ var init_port_parser = __esm({
             if (metadata.dataType !== void 0) dataType = metadata.dataType;
             if (metadata.mergeStrategy !== void 0) mergeStrategy = metadata.mergeStrategy;
             if (metadata.hidden) hidden = true;
+            if (metadata.customMetadata) {
+              customMetadata = { ...customMetadata, ...metadata.customMetadata };
+            }
           }
         }
         if (ctx.descriptionClause) {
@@ -32046,7 +32063,8 @@ var init_port_parser = __esm({
           ...dataType && { dataType },
           ...mergeStrategy && { mergeStrategy },
           ...hidden && { hidden },
-          ...description && { description }
+          ...description && { description },
+          ...customMetadata && { customMetadata }
         };
       }
       outputPort(ctx) {
@@ -32060,6 +32078,7 @@ var init_port_parser = __esm({
           scope = this.visit(ctx.scopeClause);
         }
         let hidden;
+        let customMetadata;
         if (ctx.metadataBracket) {
           for (const bracket of ctx.metadataBracket) {
             const metadata = this.visit(bracket);
@@ -32067,6 +32086,9 @@ var init_port_parser = __esm({
             if (metadata.placement !== void 0) placement = metadata.placement;
             if (metadata.dataType !== void 0) dataType = metadata.dataType;
             if (metadata.hidden) hidden = true;
+            if (metadata.customMetadata) {
+              customMetadata = { ...customMetadata, ...metadata.customMetadata };
+            }
           }
         }
         if (ctx.descriptionClause) {
@@ -32080,7 +32102,8 @@ var init_port_parser = __esm({
           ...placement && { placement },
           ...dataType && { dataType },
           ...hidden && { hidden },
-          ...description && { description }
+          ...description && { description },
+          ...customMetadata && { customMetadata }
         };
       }
       stepPort(ctx) {
@@ -32104,6 +32127,7 @@ var init_port_parser = __esm({
         let dataType;
         let mergeStrategy;
         let hidden;
+        let customMetadata;
         if (ctx.orderAttr) {
           for (const attr of ctx.orderAttr) {
             order = this.visit(attr);
@@ -32127,7 +32151,14 @@ var init_port_parser = __esm({
         if (ctx.hiddenAttr) {
           hidden = true;
         }
-        return { order, placement, dataType, mergeStrategy, hidden };
+        if (ctx.customAttr) {
+          customMetadata = customMetadata || {};
+          for (const attr of ctx.customAttr) {
+            const { key, value: value2 } = this.visit(attr);
+            customMetadata[key] = value2;
+          }
+        }
+        return { order, placement, dataType, mergeStrategy, hidden, customMetadata };
       }
       orderAttr(ctx) {
         return parseInt(ctx.orderValue[0].image, 10);
@@ -32144,6 +32175,25 @@ var init_port_parser = __esm({
       mergeStrategyAttr(ctx) {
         return ctx.mergeStrategyValue[0].image;
       }
+      customAttr(ctx) {
+        const key = ctx.customKey[0].image;
+        let value2;
+        if (ctx.customStrVal) {
+          const raw = ctx.customStrVal[0].image;
+          value2 = raw.slice(1, -1);
+        } else if (ctx.customTrue) {
+          value2 = true;
+        } else if (ctx.customFalse) {
+          value2 = false;
+        } else if (ctx.customIntVal) {
+          value2 = parseInt(ctx.customIntVal[0].image, 10);
+        } else if (ctx.customIdVal) {
+          value2 = ctx.customIdVal[0].image;
+        } else {
+          value2 = "";
+        }
+        return { key, value: value2 };
+      }
       descriptionClause(ctx) {
         if (ctx.Identifier) {
           return ctx.Identifier.map((token) => token.image).join(" ");
@@ -34219,7 +34269,7 @@ var init_jsdoc_parser = __esm({
         if (!result) {
           return;
         }
-        const { name, defaultValue, isOptional, scope, order, mergeStrategy, hidden, description } = result;
+        const { name, defaultValue, isOptional, scope, order, mergeStrategy, hidden, description, customMetadata } = result;
         let type2;
         let tsType;
         const isScopedStepInput = scope && isScopedMandatoryPort(name);
@@ -34280,7 +34330,9 @@ var init_jsdoc_parser = __esm({
           ...scope && { scope },
           ...mergeStrategy && { mergeStrategy },
           ...hidden && { hidden },
-          ...order !== void 0 && { metadata: { order } },
+          ...(order !== void 0 || customMetadata) && {
+            metadata: { ...order !== void 0 && { order }, ...customMetadata }
+          },
           ...tsType && { tsType }
         };
       }
@@ -34294,7 +34346,7 @@ var init_jsdoc_parser = __esm({
         if (!result) {
           return;
         }
-        const { name, scope, order, hidden, description } = result;
+        const { name, scope, order, hidden, description, customMetadata } = result;
         let type2;
         let tsType;
         const isScopedStepOutput = scope && isScopedMandatoryPort(name);
@@ -34348,7 +34400,9 @@ var init_jsdoc_parser = __esm({
           label: description?.trim(),
           ...scope && { scope },
           ...hidden && { hidden },
-          ...order !== void 0 && { metadata: { order } },
+          ...(order !== void 0 || customMetadata) && {
+            metadata: { ...order !== void 0 && { order }, ...customMetadata }
+          },
           ...tsType && { tsType }
         };
       }
@@ -34386,7 +34440,7 @@ var init_jsdoc_parser = __esm({
         if (!result) {
           return;
         }
-        const { name, order, description } = result;
+        const { name, order, description, customMetadata } = result;
         let type2 = "ANY";
         if (isSuccessPort(name) || isFailurePort(name)) {
           type2 = "STEP";
@@ -34407,7 +34461,9 @@ var init_jsdoc_parser = __esm({
         config2.returnPorts[name] = {
           dataType: type2,
           label: description?.trim(),
-          ...order !== void 0 && { metadata: { order } }
+          ...(order !== void 0 || customMetadata) && {
+            metadata: { ...order !== void 0 && { order }, ...customMetadata }
+          }
         };
       }
       /**
@@ -105820,7 +105876,7 @@ function displayInstalledPackage(pkg) {
 // src/cli/index.ts
 init_logger();
 init_error_utils();
-var version2 = true ? "0.17.9" : "0.0.0-dev";
+var version2 = true ? "0.17.10" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("flow-weaver").description("Flow Weaver Annotations - Compile and validate workflow files").option("-v, --version", "Output the current version").option("--no-color", "Disable colors").option("--color", "Force colors").on("option:version", () => {
   logger.banner(version2);

package/dist/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.17.9";
+export declare const VERSION = "0.17.10";
 //# sourceMappingURL=generated-version.d.ts.map

package/dist/generated-version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.ts — do not edit manually
-export const VERSION = '0.17.9';
+export const VERSION = '0.17.10';
 //# sourceMappingURL=generated-version.js.map

package/dist/jsdoc-parser.js

@@ -522,7 +522,7 @@ export class JSDocParser {
         if (!result) {
             return;
         }
-        const { name, defaultValue, isOptional, scope, order, mergeStrategy, hidden, description } = result;
+        const { name, defaultValue, isOptional, scope, order, mergeStrategy, hidden, description, customMetadata } = result;
         // Infer type from signature or scope callback return type
         let type;
         let tsType;
@@ -599,7 +599,9 @@ export class JSDocParser {
             ...(scope && { scope }),
             ...(mergeStrategy && { mergeStrategy: mergeStrategy }),
             ...(hidden && { hidden }),
-            ...(order !== undefined && { metadata: { order } }),
+            ...((order !== undefined || customMetadata) && {
+                metadata: { ...(order !== undefined && { order }), ...customMetadata },
+            }),
             ...(tsType && { tsType }),
         };
     }
@@ -613,7 +615,7 @@ export class JSDocParser {
         if (!result) {
             return;
         }
-        const { name, scope, order, hidden, description } = result;
+        const { name, scope, order, hidden, description, customMetadata } = result;
         // Infer type from return type or scope callback parameter
         let type;
         let tsType;
@@ -683,7 +685,9 @@ export class JSDocParser {
             label: description?.trim(),
             ...(scope && { scope }),
             ...(hidden && { hidden }),
-            ...(order !== undefined && { metadata: { order } }),
+            ...((order !== undefined || customMetadata) && {
+                metadata: { ...(order !== undefined && { order }), ...customMetadata },
+            }),
             ...(tsType && { tsType }),
         };
     }
@@ -727,7 +731,7 @@ export class JSDocParser {
         if (!result) {
             return;
         }
-        const { name, order, description } = result;
+        const { name, order, description, customMetadata } = result;
         // Infer type from return type signature
         let type = 'ANY';
         if (isSuccessPort(name) || isFailurePort(name)) {
@@ -753,7 +757,9 @@ export class JSDocParser {
         config.returnPorts[name] = {
             dataType: type,
             label: description?.trim(),
-            ...(order !== undefined && { metadata: { order } }),
+            ...((order !== undefined || customMetadata) && {
+                metadata: { ...(order !== undefined && { order }), ...customMetadata },
+            }),
         };
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.17.9",
+  "version": "0.17.10",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",