veryfront 0.1.76 → 0.1.77

package/esm/src/platform/index.d.ts

@@ -15,5 +15,6 @@ export { lookup as lookupMimeType } from "./compat/media-types.js";
 export { createKVStore, MemoryKv } from "./compat/kv/index.js";
 export { isDeno } from "./compat/runtime.js";
 export { createFSAdapter, VeryfrontFSAdapter } from "./adapters/fs/index.js";
+export { enhanceAdapterWithFS, isExtendedFSAdapter } from "./adapters/fs/index.js";
 export { VeryfrontApiClient } from "./adapters/veryfront-api-client/index.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/platform/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EACL,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,aAAa,EACb,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,WAAW,EACX,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,KAAK,UAAU,EACf,KAAK,EACL,OAAO,EACP,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EACL,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,aAAa,EACb,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,WAAW,EACX,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,KAAK,UAAU,EACf,KAAK,EACL,OAAO,EACP,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC"}

package/esm/src/platform/index.js

@@ -22,5 +22,6 @@ export { createKVStore, MemoryKv } from "./compat/kv/index.js";
 export { isDeno } from "./compat/runtime.js";
 // Adapters: filesystem
 export { createFSAdapter, VeryfrontFSAdapter } from "./adapters/fs/index.js";
+export { enhanceAdapterWithFS, isExtendedFSAdapter } from "./adapters/fs/index.js";
 // Adapters: API client
 export { VeryfrontApiClient } from "./adapters/veryfront-api-client/index.js";

package/esm/src/server/runtime-handler/index.d.ts

@@ -14,7 +14,7 @@ import type { Handler } from "../../types/index.js";
 import { ApiHandlerWrapper } from "../handlers/request/api/index.js";
 export { parseProxyEnvironment, type ProxyEnvironment } from "./proxy-environment.js";
 /** Handler names in registration order. */
-export declare const HANDLER_NAMES: readonly ["AuthHandler", "CsrfHandler", "HMRHandler", "CorsHandler", "HealthHandler", "MetricsHandler", "MemoryDebugHandler", "ClientLogHandler", "DevEndpointsHandler", "StylesCSSHandler", "DebugContextHandler", "OpenAPIHandler", "OpenAPIDocsHandler", "InternalAgentsListHandler", "InternalTasksListHandler", "AgentStreamHandler", "AgentRunResumeHandler", "AgentRunCancelHandler", "ChannelInvokeHandler", "DevDashboardHandler", "ProjectsHandler", "StudioBridgeModulesHandler", "CSSHandler", "DevFileHandler", "SnippetHandler", "StaticHandler", "LibModulesHandler", "RSCHandler", "ModuleHandler", "ApiHandlerWrapper", "MarkdownPreviewHandler", "SSRHandler", "NotFoundHandler"];
+export declare const HANDLER_NAMES: readonly ["AuthHandler", "CsrfHandler", "HMRHandler", "CorsHandler", "HealthHandler", "MetricsHandler", "MemoryDebugHandler", "ClientLogHandler", "DevEndpointsHandler", "StylesCSSHandler", "DebugContextHandler", "OpenAPIHandler", "OpenAPIDocsHandler", "InternalAgentsListHandler", "AgentStreamHandler", "AgentRunResumeHandler", "AgentRunCancelHandler", "ChannelInvokeHandler", "DevDashboardHandler", "ProjectsHandler", "StudioBridgeModulesHandler", "CSSHandler", "DevFileHandler", "SnippetHandler", "StaticHandler", "LibModulesHandler", "RSCHandler", "ModuleHandler", "ApiHandlerWrapper", "MarkdownPreviewHandler", "SSRHandler", "NotFoundHandler"];
 /** Union of all registered handler names. */
 export type HandlerName = (typeof HANDLER_NAMES)[number];
 /**

package/esm/src/server/runtime-handler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAQlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA0BpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA+DrE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,2CAA2C;AAC3C,eAAO,MAAM,aAAa,qqBAkChB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0CD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuB5D;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAsYnF;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAQlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA0BpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA8DrE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,2CAA2C;AAC3C,eAAO,MAAM,aAAa,yoBAiChB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyCD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuB5D;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAsYnF;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}

package/esm/src/server/runtime-handler/index.js

@@ -43,7 +43,6 @@ import { MarkdownPreviewHandler } from "../handlers/preview/markdown-preview.han
 import { OpenAPIHandler } from "../handlers/request/openapi.handler.js";
 import { OpenAPIDocsHandler } from "../handlers/request/openapi-docs.handler.js";
 import { InternalAgentsListHandler } from "../handlers/request/internal-agents-list.handler.js";
-import { InternalTasksListHandler } from "../handlers/request/internal-tasks-list.handler.js";
 import { AgentStreamHandler } from "../handlers/request/agent-stream.handler.js";
 import { AgentRunResumeHandler } from "../handlers/request/agent-run-resume.handler.js";
 import { AgentRunCancelHandler } from "../handlers/request/agent-run-cancel.handler.js";
@@ -84,7 +83,6 @@ export const HANDLER_NAMES = [
     "OpenAPIHandler",
     "OpenAPIDocsHandler",
     "InternalAgentsListHandler",
-    "InternalTasksListHandler",
     "AgentStreamHandler",
     "AgentRunResumeHandler",
     "AgentRunCancelHandler",
@@ -120,7 +118,6 @@ const handlerFactories = {
     OpenAPIHandler: () => new OpenAPIHandler(),
     OpenAPIDocsHandler: () => new OpenAPIDocsHandler(),
     InternalAgentsListHandler: () => new InternalAgentsListHandler(),
-    InternalTasksListHandler: () => new InternalTasksListHandler(),
     AgentStreamHandler: () => new AgentStreamHandler(),
     AgentRunResumeHandler: () => new AgentRunResumeHandler(),
     AgentRunCancelHandler: () => new AgentRunCancelHandler(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.76",
+  "version": "0.1.77",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/cli/commands/pull/command.ts

@@ -159,7 +159,7 @@ export function buildFilesListUrl(projectSlug: string, source: PullSource): stri
     case "release":
       return `/projects/${projectSlug}/releases/${encodeURIComponent(source.version)}/files`;
     case "branch":
-      return `/projects/${projectSlug}/branches/${encodeURIComponent(source.name)}/files`;
+      return `/projects/${projectSlug}/files?branch=${encodeURIComponent(source.name)}`;
     case "main":
       return `/projects/${projectSlug}/files`;
   }
@@ -211,9 +211,9 @@ export function buildFileContentUrl(projectSlug: string, path: string, source: P
         encodeURIComponent(source.version)
       }/files/${encodedPath}`;
     case "branch":
-      return `/projects/${projectSlug}/branches/${
+      return `/projects/${projectSlug}/files/${encodedPath}?branch=${
         encodeURIComponent(source.name)
-      }/files/${encodedPath}`;
+      }`;
     case "main":
       return `/projects/${projectSlug}/files/${encodedPath}`;
   }

package/src/cli/commands/task/command.ts

@@ -9,14 +9,12 @@ import * as dntShim from "../../../_dnt.shims.js";
 
 import { cliLogger } from "../../utils/index.js";
 import { exitProcess } from "../../utils/index.js";
+import { withProjectSourceContext } from "../../shared/project-source-context.js";
 import type { TaskArgs } from "./handler.js";
 
 export interface TaskOptions extends TaskArgs {}
 
 export async function taskCommand(options: TaskOptions): Promise<void> {
-  const { getAdapter } = await import(
-    "../../../src/platform/adapters/detect.js"
-  );
   const { discoverTasks } = await import(
     "../../../src/task/discovery.js"
   );
@@ -32,67 +30,78 @@ export async function taskCommand(options: TaskOptions): Promise<void> {
   }
 
   const projectDir = dntShim.Deno.cwd();
-  const adapter = await getAdapter();
+  await withProjectSourceContext(
+    projectDir,
+    async ({ adapter, config, projectId, proxyContext }) => {
+      const sourceLabel = proxyContext?.branchRef
+        ? `branch ${proxyContext.branchRef}`
+        : proxyContext
+        ? "main"
+        : `${projectDir}/tasks/...`;
 
-  cliLogger.info(`Discovering tasks in ${projectDir}/tasks/...`);
+      cliLogger.info(`Discovering tasks in ${sourceLabel}`);
 
-  const { tasks, errors } = await discoverTasks({
-    projectDir,
-    adapter,
-    debug: options.debug,
-  });
+      const { tasks, errors } = await discoverTasks({
+        projectDir,
+        adapter,
+        config,
+        debug: options.debug,
+      });
 
-  if (errors.length > 0 && options.debug) {
-    for (const err of errors) {
-      cliLogger.warn(`  Warning: ${err.filePath}: ${err.error}`);
-    }
-  }
+      if (errors.length > 0 && options.debug) {
+        for (const err of errors) {
+          cliLogger.warn(`  Warning: ${err.filePath}: ${err.error}`);
+        }
+      }
 
-  const task = tasks.find((t) => t.id === taskName);
-  if (!task) {
-    cliLogger.error(`Task "${taskName}" not found.`);
-    if (tasks.length > 0) {
-      cliLogger.info("Available tasks:");
-      for (const t of tasks) {
-        cliLogger.info(`  - ${t.id}${t.name !== t.id ? ` (${t.name})` : ""}`);
+      const task = tasks.find((t) => t.id === taskName);
+      if (!task) {
+        cliLogger.error(`Task "${taskName}" not found.`);
+        if (tasks.length > 0) {
+          cliLogger.info("Available tasks:");
+          for (const t of tasks) {
+            cliLogger.info(`  - ${t.id}${t.name !== t.id ? ` (${t.name})` : ""}`);
+          }
+        } else {
+          cliLogger.info("No tasks found. Create a task file in tasks/ directory:");
+          cliLogger.info("  tasks/my-task.ts");
+        }
+        exitProcess(1);
+        return;
       }
-    } else {
-      cliLogger.info("No tasks found. Create a task file in tasks/ directory:");
-      cliLogger.info("  tasks/my-task.ts");
-    }
-    exitProcess(1);
-    return;
-  }
 
-  // Parse config JSON if provided
-  let config: Record<string, unknown> = {};
-  if (options.config) {
-    try {
-      config = JSON.parse(options.config);
-    } catch {
-      cliLogger.error("Invalid --config JSON");
-      exitProcess(1);
-      return;
-    }
-  }
+      let taskConfig: Record<string, unknown> = {};
+      if (options.config) {
+        try {
+          taskConfig = JSON.parse(options.config);
+        } catch {
+          cliLogger.error("Invalid --config JSON");
+          exitProcess(1);
+          return;
+        }
+      }
 
-  cliLogger.info(`Running task: ${task.name} (${task.id})`);
-  cliLogger.info("");
+      cliLogger.info(`Running task: ${task.name} (${task.id})`);
+      cliLogger.info("");
 
-  const result = await runTask({
-    task,
-    config,
-    debug: options.debug,
-  });
+      const result = await runTask({
+        task,
+        config: taskConfig,
+        projectId,
+        debug: options.debug,
+      });
 
-  cliLogger.info("");
-  if (result.success) {
-    cliLogger.info(`Task completed in ${result.durationMs}ms`);
-    if (result.result !== undefined) {
-      cliLogger.info(`Result: ${JSON.stringify(result.result, null, 2)}`);
-    }
-  } else {
-    cliLogger.error(`Task failed after ${result.durationMs}ms: ${result.error}`);
-    exitProcess(1);
-  }
+      cliLogger.info("");
+      if (result.success) {
+        cliLogger.info(`Task completed in ${result.durationMs}ms`);
+        if (result.result !== undefined) {
+          cliLogger.info(`Result: ${JSON.stringify(result.result, null, 2)}`);
+        }
+        return;
+      }
+
+      cliLogger.error(`Task failed after ${result.durationMs}ms: ${result.error}`);
+      exitProcess(1);
+    },
+  );
 }

package/src/cli/commands/workflow/command-help.ts

@@ -0,0 +1,21 @@
+import type { CommandHelp } from "../../help/types.js";
+
+export const workflowHelp: CommandHelp = {
+  name: "workflow",
+  description: "Run a workflow from the app/workflows directory",
+  usage: "veryfront workflow run <id> [options]",
+  options: [
+    {
+      flag: "--input <json>",
+      description: "JSON input to pass to the workflow",
+    },
+    {
+      flag: "--debug",
+      description: "Enable debug logging",
+    },
+  ],
+  examples: [
+    "veryfront workflow run publish-site",
+    'veryfront workflow run content-pipeline --input \'{"topic":"AI"}\'',
+  ],
+};

package/src/cli/commands/workflow/command.ts

@@ -0,0 +1,152 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { cliLogger } from "../../utils/index.js";
+import { exitProcess } from "../../utils/index.js";
+import { withProjectSourceContext } from "../../shared/project-source-context.js";
+import { getEnv } from "../../../src/platform/index.js";
+import type { WorkflowArgs } from "./handler.js";
+
+const WORKFLOW_STATUS_POLL_INTERVAL_MS = 1_000;
+
+export interface WorkflowOptions extends WorkflowArgs {}
+
+async function createWorkflowClient(debug: boolean) {
+  const { createWorkflowClient } = await import(
+    "../../../src/workflow/api/workflow-client.js"
+  );
+
+  const redisUrl = getEnv("REDIS_URL")?.trim();
+  if (!redisUrl) {
+    return createWorkflowClient({ debug });
+  }
+
+  const { RedisBackend } = await import(
+    "../../../src/workflow/backends/redis.js"
+  );
+
+  const backend = new RedisBackend({ url: redisUrl, debug });
+  if (backend.initialize) {
+    await backend.initialize();
+  }
+
+  return createWorkflowClient({ backend, debug });
+}
+
+async function waitForWorkflowExit(
+  client: Awaited<ReturnType<typeof createWorkflowClient>>,
+  runId: string,
+): Promise<void> {
+  while (true) {
+    const run = await client.getRun(runId);
+    if (!run) {
+      throw new Error(`Workflow run not found: ${runId}`);
+    }
+
+    if (run.status === "completed") {
+      cliLogger.info(`Workflow completed: ${runId}`);
+      if (run.output !== undefined) {
+        cliLogger.info(`Result: ${JSON.stringify(run.output, null, 2)}`);
+      }
+      return;
+    }
+
+    if (run.status === "waiting") {
+      cliLogger.info(`Workflow is waiting: ${runId}`);
+      return;
+    }
+
+    if (run.status === "failed") {
+      throw new Error(run.error?.message || `Workflow failed: ${runId}`);
+    }
+
+    if (run.status === "cancelled") {
+      throw new Error(`Workflow was cancelled: ${runId}`);
+    }
+
+    await new Promise((resolve) => dntShim.setTimeout(resolve, WORKFLOW_STATUS_POLL_INTERVAL_MS));
+  }
+}
+
+export async function workflowCommand(options: WorkflowOptions): Promise<void> {
+  if (options.action !== "run") {
+    cliLogger.error(`Unknown workflow action: ${options.action}`);
+    exitProcess(1);
+    return;
+  }
+
+  const workflowId = options.name;
+  if (!workflowId) {
+    cliLogger.error("Workflow ID is required. Usage: veryfront workflow run <id>");
+    exitProcess(1);
+    return;
+  }
+
+  let input: Record<string, unknown> = {};
+  if (options.input) {
+    try {
+      input = JSON.parse(options.input);
+    } catch {
+      cliLogger.error("Invalid --input JSON");
+      exitProcess(1);
+      return;
+    }
+  }
+
+  const { discoverWorkflows } = await import(
+    "../../../src/workflow/discovery/index.js"
+  );
+
+  await withProjectSourceContext(dntShim.Deno.cwd(), async ({ adapter, config, proxyContext }) => {
+    const sourceLabel = proxyContext?.branchRef
+      ? `branch ${proxyContext.branchRef}`
+      : proxyContext
+      ? "main"
+      : `${dntShim.Deno.cwd()}/app/workflows/...`;
+
+    cliLogger.info(`Discovering workflows in ${sourceLabel}`);
+
+    const discovery = await discoverWorkflows({
+      projectDir: dntShim.Deno.cwd(),
+      adapter,
+      config,
+      debug: options.debug,
+    });
+
+    if (discovery.errors.length > 0 && options.debug) {
+      for (const err of discovery.errors) {
+        cliLogger.warn(`  Warning: ${err.filePath}: ${err.error}`);
+      }
+    }
+
+    const workflow = discovery.workflows.find((candidate) => candidate.id === workflowId);
+    if (!workflow) {
+      cliLogger.error(`Workflow "${workflowId}" not found.`);
+      if (discovery.workflows.length > 0) {
+        cliLogger.info("Available workflows:");
+        for (const candidate of discovery.workflows) {
+          cliLogger.info(`  - ${candidate.id}`);
+        }
+      } else {
+        cliLogger.info("No workflows found. Create a workflow file in app/workflows/.");
+      }
+      exitProcess(1);
+      return;
+    }
+
+    const client = await createWorkflowClient(options.debug);
+
+    try {
+      client.register(workflow.definition);
+      cliLogger.info(`Running workflow: ${workflow.id}`);
+      cliLogger.info("");
+
+      const handle = await client.start(workflow.id, input);
+      await waitForWorkflowExit(client, handle.runId);
+    } finally {
+      await client.destroy();
+    }
+  }).catch((error: unknown) => {
+    const message = error instanceof Error ? error.message : String(error);
+    cliLogger.error(message);
+    exitProcess(1);
+  });
+}

package/src/cli/commands/workflow/handler.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { createArgParser, parseArgsOrThrow } from "../../shared/args.js";
+import type { ParsedArgs } from "../../shared/types.js";
+
+const WorkflowArgsSchema = z.object({
+  action: z.enum(["run"]),
+  name: z.string(),
+  input: z.string().optional(),
+  debug: z.boolean().default(false),
+});
+
+export type WorkflowArgs = z.infer<typeof WorkflowArgsSchema>;
+
+export const parseWorkflowArgs = createArgParser(WorkflowArgsSchema, {
+  action: { keys: ["action"], type: "string", positional: 0 },
+  name: { keys: ["name"], type: "string", positional: 1 },
+  input: { keys: ["input"], type: "string" },
+  debug: { keys: ["debug"], type: "boolean" },
+});
+
+export async function handleWorkflowCommand(args: ParsedArgs): Promise<void> {
+  const opts = parseArgsOrThrow(parseWorkflowArgs, "workflow", args);
+  const { workflowCommand } = await import("./command.js");
+  await workflowCommand(opts);
+}

package/src/cli/help/command-definitions.ts

@@ -36,6 +36,7 @@ import { mcpHelp } from "../commands/mcp/command-help.js";
 import { issuesHelp } from "../commands/issues/command-help.js";
 import { startHelp } from "../commands/start/command-help.js";
 import { taskHelp } from "../commands/task/command-help.js";
+import { workflowHelp } from "../commands/workflow/command-help.js";
 
 /**
  * Central registry of all command help definitions.
@@ -71,4 +72,5 @@ export const COMMANDS: CommandRegistry = {
   issues: issuesHelp,
   start: startHelp,
   task: taskHelp,
+  workflow: workflowHelp,
 };

package/src/cli/router.ts

@@ -31,6 +31,7 @@ import { handleStartCommand } from "./commands/start/handler.js";
 import { handleStudioCommand } from "./commands/studio/handler.js";
 import { handleUpCommand } from "./commands/up/index.js";
 import { handleTaskCommand } from "./commands/task/handler.js";
+import { handleWorkflowCommand } from "./commands/workflow/handler.js";
 import { handleWorkerCommand } from "./commands/worker/handler.js";
 import { login, logout, whoami } from "./auth/index.js";
 import { parseLoginMethod } from "./auth/utils.js";
@@ -81,6 +82,7 @@ const commands: Record<string, (args: ParsedArgs) => Promise<void>> = {
   "issues": handleIssuesCommand,
   "start": handleStartCommand,
   "task": handleTaskCommand,
+  "workflow": handleWorkflowCommand,
   "worker": handleWorkerCommand,
 };
 

package/src/cli/shared/project-source-context.ts

@@ -0,0 +1,96 @@
+import { getConfig, type VeryfrontConfig } from "../../src/config/index.js";
+import {
+  enhanceAdapterWithFS,
+  getEnv,
+  isExtendedFSAdapter,
+  runtime,
+  type RuntimeAdapter,
+} from "../../src/platform/index.js";
+
+interface ProxyProjectSourceContext {
+  projectSlug: string;
+  token: string;
+  projectId?: string;
+  branchRef?: string | null;
+}
+
+export interface ProjectSourceExecutionContext {
+  adapter: RuntimeAdapter;
+  config: VeryfrontConfig;
+  projectDir: string;
+  projectId?: string;
+  proxyContext?: ProxyProjectSourceContext;
+}
+
+function getProxyProjectSourceContext(): ProxyProjectSourceContext | null {
+  const projectSlug = getEnv("VERYFRONT_PROJECT_SLUG")?.trim();
+  const token = getEnv("VERYFRONT_API_TOKEN")?.trim();
+
+  if (!projectSlug || !token) {
+    return null;
+  }
+
+  const projectId = getEnv("VERYFRONT_PROJECT_ID")?.trim();
+  const branchRef = getEnv("VERYFRONT_BRANCH_REF")?.trim();
+
+  return {
+    projectSlug,
+    token,
+    projectId: projectId || undefined,
+    branchRef: branchRef || null,
+  };
+}
+
+async function loadProjectConfig(
+  projectDir: string,
+  adapter: RuntimeAdapter,
+  proxyContext?: ProxyProjectSourceContext,
+): Promise<VeryfrontConfig> {
+  const cacheKey = proxyContext?.projectId ?? proxyContext?.projectSlug;
+  return await getConfig(projectDir, adapter, cacheKey ? { cacheKey } : undefined);
+}
+
+export async function withProjectSourceContext<T>(
+  projectDir: string,
+  run: (context: ProjectSourceExecutionContext) => Promise<T>,
+): Promise<T> {
+  const baseAdapter = await runtime.get();
+  const initialConfig = await getConfig(projectDir, baseAdapter);
+  const adapter = await enhanceAdapterWithFS(baseAdapter, initialConfig, projectDir);
+  const proxyContext = getProxyProjectSourceContext();
+
+  if (
+    proxyContext &&
+    isExtendedFSAdapter(adapter.fs) &&
+    adapter.fs.isMultiProjectMode()
+  ) {
+    return await adapter.fs.runWithContext(
+      proxyContext.projectSlug,
+      proxyContext.token,
+      async () => {
+        const config = await loadProjectConfig(projectDir, adapter, proxyContext);
+        return await run({
+          adapter,
+          config,
+          projectDir,
+          projectId: proxyContext.projectId,
+          proxyContext,
+        });
+      },
+      proxyContext.projectId,
+      {
+        productionMode: false,
+        branch: proxyContext.branchRef ?? null,
+      },
+    );
+  }
+
+  const config = await loadProjectConfig(projectDir, adapter);
+  return await run({
+    adapter,
+    config,
+    projectDir,
+    projectId: proxyContext?.projectId,
+    proxyContext: proxyContext ?? undefined,
+  });
+}

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.76",
+  "version": "0.1.77",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [
@@ -114,6 +114,7 @@ export default {
     "#cli/shared/types": "./cli/shared/types.ts",
     "#cli/shared/constants": "./cli/shared/constants.ts",
     "#cli/shared/config": "./cli/shared/config.ts",
+    "#cli/shared/project-source-context": "./cli/shared/project-source-context.ts",
     "#cli/shared/slug": "./cli/shared/slug.ts",
     "#cli/shared/reserve-slug": "./cli/shared/reserve-slug.ts",
     "#cli/shared/server-startup": "./cli/shared/server-startup.ts",