@synergenius/flow-weaver 0.30.0 → 0.30.2

package/README.md

@@ -18,15 +18,27 @@ Flow Weaver is a TypeScript workflow compiler. Define workflows with JSDoc annot
 
 Build AI agent workflows, data pipelines, or automation scripts through natural language using MCP tools in Claude Code, Cursor, Windsurf, VS Code, JetBrains, Codex, or any MCP-compatible editor. Or write them by hand with annotations the same way you write JSDoc today.
 
-## Project Status
+## About me & my vision
+
+Hey, I am [Ricardo Morais](https://linkedin.com/in/moraispgsi), the project's founder and owner. 
+
+I have always wondered why Visual Programming never took off. After understanding why I tried to address most of the concerns from the development community:
+  - No lock-in: code is compiled and yours, not dependent on this library. You can remove the annotation after compiling and the file is standalone.
+  - The code is the source of truth, visual part runs on top, this allows you to create your workflows visually in the Studio, at the end of the day it is just plain Typescript code that you or any LLM can understand and iterate.
+  - It being just code opens a lot of doors for you, like using Git for version control, doing all sort of stuff you already do with code like testing, linting, automating, everything.
+  - In the era of LLMs and agents, being able to have that control is crucial, it is not a black box, you can see everything and so can your assistant.
 
-Flow Weaver is in **active alpha**. The compiler, validator, CLI, and MCP tools are stable and thoroughly tested. The test suite covers thousands of cases across parsing, compilation, validation, diffing, and deployment. CI runs on every commit.
+As of now this is a solo project and I am building it in the open. There is a lot to do and rough edges to smooth out. If you run into issues or have questions, the [Discord](https://discord.gg/6Byh3ur2bk) is the best place to reach out. Every issue and question gets a response. I genuinely want to hear from you.
+
+If this resonates with what you have been looking for, give it a try and let me know how it goes. Stars, feedback, and honest criticism all help equally.
+
+## Project Status
 
-This started as a curiosity by [Ricardo Morais](https://linkedin.com/in/moraispgsi) into why visual programming never took off and whether code-first and visual editing could actually coexist. It has grown into something real. It is actively maintained, with releases shipping regularly. If you run into issues or have questions, the [Discord](https://discord.gg/6Byh3ur2bk) is the best place to reach out. Every issue and question gets a response, usually within a day.
+Flow Weaver is in **beta**. The compiler, validator, CLI, and MCP tools are stable and thoroughly tested. The test suite covers thousands of cases across parsing, compilation, validation, diffing, and deployment. CI runs on every commit.
 
 **Flow Weaver Studio**, the browser-based visual IDE, is the next major milestone and is being actively built. Core editing (canvas, terminal, diagnostics) is live today. The visual debugger, AI chat assistant, version history, and deployment dashboard are in progress. You can follow development on Discord or in the [GitHub releases](https://github.com/synergenius-fw/flow-weaver/releases).
 
-Breaking changes may occur between minor versions during alpha. Pin your version in `package.json` if stability matters for your project.
+Breaking changes may still occur between minor versions during beta. Pin your version in `package.json` if stability matters for your project.
 
 ## Capabilities
 
@@ -224,11 +236,11 @@ export async function supportAgent(
 
 Run `fw --help` or `fw <command> --help` for full options.
 
-## Flow Weaver Studio (Early Beta)
+## Flow Weaver Studio (Beta)
 
 A browser-based visual IDE for building workflows. Canvas editor, integrated terminal, real-time diagnostics, and the full CLI available in the cloud.
 
-Studio is in early beta. Core editing is live. The visual debugger, AI chat assistant, version history, and deployment dashboard are being actively developed and will ship incrementally. The cloud platform is not yet production-ready, and paid plans are not available yet. Use it to explore and experiment, but expect rough edges.
+Studio is in beta. Core editing is live. The visual debugger, AI chat assistant, version history, and deployment dashboard are being actively developed and will ship incrementally. The cloud platform is not yet production-ready, and paid plans are not available yet. Use it to explore and experiment, but expect rough edges.
 
 [Open Studio](https://flowweaver.ai/studio) · [Learn more](https://flowweaver.ai/features)
 

package/dist/annotation-generator.js

@@ -627,7 +627,17 @@ export function generateNodeInstanceTag(instance) {
     if (instance.config?.x !== undefined && instance.config?.y !== undefined) {
         positionAttr = ` [position: ${Math.round(instance.config.x)} ${Math.round(instance.config.y)}]`;
     }
-    return ` * @node ${instance.id} ${instance.nodeType}${parent}${labelAttr}${portOrderAttr}${portLabelAttr}${exprAttr}${pullExecutionAttr}${minimizedAttr}${colorAttr}${iconAttr}${tagsAttr}${suppressAttr}${sizeAttr}${positionAttr}`;
+    // Generate [job: "name"] attribute if present (CI/CD job group)
+    let jobAttr = '';
+    if (instance.job) {
+        jobAttr = ` [job: "${instance.job}"]`;
+    }
+    // Generate [environment: "name"] attribute if present (CI/CD environment)
+    let environmentAttr = '';
+    if (instance.environment) {
+        environmentAttr = ` [environment: "${instance.environment}"]`;
+    }
+    return ` * @node ${instance.id} ${instance.nodeType}${parent}${labelAttr}${portOrderAttr}${portLabelAttr}${exprAttr}${pullExecutionAttr}${minimizedAttr}${colorAttr}${iconAttr}${tagsAttr}${suppressAttr}${sizeAttr}${positionAttr}${jobAttr}${environmentAttr}`;
 }
 /**
  * Generate a TypeScript function signature from a node type definition.

package/dist/cli/commands/describe.js

@@ -349,7 +349,7 @@ export async function describeCommand(input, options = {}) {
     }
     try {
         // Parse the workflow
-        const parseResult = await parseWorkflow(filePath, { workflowName });
+        const parseResult = await parseWorkflow(filePath, { workflowName, projectDir: path.dirname(filePath) });
         if (parseResult.errors.length > 0) {
             throw new Error(`Parse errors:\n${parseResult.errors.map((err) => `  ${err}`).join('\n')}`);
         }

package/dist/cli/commands/diagram.js

@@ -5,6 +5,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { fileToSVG, fileToHTML, fileToASCII } from '../../diagram/index.js';
+import { parser } from '../../parser.js';
 import { logger } from '../utils/logger.js';
 import { safeWriteFile } from '../utils/safe-write.js';
 const ASCII_FORMATS = new Set(['ascii', 'ascii-compact', 'text']);
@@ -14,6 +15,8 @@ export async function diagramCommand(input, options = {}) {
     if (!fs.existsSync(filePath)) {
         throw new Error(`File not found: ${filePath}`);
     }
+    // Load marketplace pack tag handlers before parsing
+    await parser.loadPackHandlers(path.dirname(filePath));
     let result;
     if (ASCII_FORMATS.has(format)) {
         result = fileToASCII(filePath, { ...diagramOptions, format });

package/dist/cli/commands/diff.js

@@ -21,8 +21,8 @@ export async function diffCommand(file1, file2, options = {}) {
     try {
         // Parse both workflows
         const [result1, result2] = await Promise.all([
-            parseWorkflow(filePath1, { workflowName }),
-            parseWorkflow(filePath2, { workflowName }),
+            parseWorkflow(filePath1, { workflowName, projectDir: path.dirname(filePath1) }),
+            parseWorkflow(filePath2, { workflowName, projectDir: path.dirname(filePath2) }),
         ]);
         if (result1.errors.length > 0) {
             throw new Error(`Parse errors in ${file1}:\n${result1.errors.map((err) => `  ${err}`).join('\n')}`);

package/dist/cli/commands/run.js

@@ -184,7 +184,7 @@ async function runCommandInner(input, options) {
             let executionOrder = resumeExecutionOrder;
             if (!executionOrder) {
                 const source = fs.readFileSync(filePath, 'utf8');
-                const parsed = await parseWorkflow(source, { workflowName: options.workflow });
+                const parsed = await parseWorkflow(source, { workflowName: options.workflow, projectDir: path.dirname(filePath) });
                 if (parsed.errors.length === 0) {
                     executionOrder = getTopologicalOrder(parsed.ast);
                 }
@@ -427,7 +427,7 @@ export async function validateMockConfig(mocks, filePath, workflowName) {
     }
     // Quick-parse the workflow to check which built-in node types are used
     try {
-        const result = await parseWorkflow(filePath, { workflowName });
+        const result = await parseWorkflow(filePath, { workflowName, projectDir: path.dirname(filePath) });
         if (result.errors.length > 0 || !result.ast?.instances)
             return;
         const usedNodeTypes = new Set(result.ast.instances.map((i) => i.nodeType));

package/dist/cli/commands/serve.js

@@ -30,6 +30,17 @@ import { logger } from '../utils/logger.js';
  * ```
  */
 export async function serveCommand(dir, options) {
+    // Check fastify is installed before proceeding
+    try {
+        await import('fastify');
+    }
+    catch {
+        logger.error('The serve command requires fastify. Install it with:');
+        logger.newline();
+        logger.log('  npm install fastify');
+        logger.newline();
+        process.exit(1);
+    }
     const workflowDir = path.resolve(dir || '.');
     // Validate directory exists
     if (!fs.existsSync(workflowDir)) {

package/dist/cli/commands/validate.js

@@ -62,7 +62,7 @@ export async function validateCommand(input, options = {}) {
             }
             try {
                 // Parse the workflow
-                const parseResult = await parseWorkflow(file, { workflowName, projectDir: process.cwd() });
+                const parseResult = await parseWorkflow(file, { workflowName, projectDir: path.dirname(path.resolve(file)) });
                 if (parseResult.warnings.length > 0) {
                     if (!json && !quiet) {
                         logger.warn(`Parse warnings in ${fileName}:`);