@agentic-surfaces/cli 0.1.23 → 0.1.24

package/README.md

@@ -0,0 +1,35 @@
+# @agentic-surfaces/cli
+
+The command-line runner for [agentic-surfaces](https://github.com/dalebaldwin/agentic-surfaces) —
+a local-first, agent-in-the-loop workflow engine. Loads a project's `agentic-surfaces.config.yaml`
++ `workflows/*.yaml` + `agents/*.md`, runs the scheduler, and serves the live dashboard.
+
+**Repo & full docs:** https://github.com/dalebaldwin/agentic-surfaces
+
+## Usage
+
+```bash
+npx -y @agentic-surfaces/cli@latest <command> [projectDir] [--ui] [--watch] [--fake]
+```
+
+| Command | What it does |
+|---|---|
+| `start <dir>` | Run the scheduler (cron triggers fire). `--ui` adds the dashboard; `--watch` restarts on config edits. |
+| `run-once <workflow.yaml>` | Run one entry workflow once, ignoring its cron. |
+| `ui [dir]` | Dashboard + scheduler (the default when no command is given). |
+| `validate <workflow.yaml>` | Parse-check a workflow. |
+
+Pin a version for reproducibility: `@agentic-surfaces/cli@0.1.x`.
+
+## Secrets
+
+Workflows use `${VAR}`. Supply via a **`.env`** in the working directory (auto-loaded), a secrets
+manager like **Doppler**, or plain `export`s. Real env / Doppler override `.env`.
+
+## Dashboard
+
+`--ui` serves http://127.0.0.1:4000 — workflow graph (with the taken path highlighted), live runs,
+per-node output, **agent activity** (reasoning + tool/MCP calls), and a **cache inspector**. Set
+`FLOW_UI_PORT` to change the port, `FLOW_NO_OPEN=1` to not open a browser.
+
+MIT licensed.

package/dist/index.js

@@ -5,6 +5,26 @@ import { loadWorkflow, runWorkflowOnce, Scheduler, loadProjectConfig, buildWorkf
 import { serve, StreamingObserver } from "@agentic-surfaces/server";
 import { buildServices } from "./services.js";
 const CONFIG = "agentic-surfaces.config.yaml";
+/**
+ * Load a `.env` file (from the cwd) into process.env, so secrets (JIRA_EMAIL, …) can be supplied
+ * without Doppler. Existing env vars are NOT overridden — so Doppler / explicit env still win.
+ * This is why `${VAR}` in workflows works whether you use Doppler, a .env, or plain exports.
+ */
+function loadDotenv(dir = process.cwd()) {
+    const path = join(dir, ".env");
+    if (!existsSync(path))
+        return;
+    for (const line of readFileSync(path, "utf8").split(/\r?\n/)) {
+        const m = line.match(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/);
+        if (!m)
+            continue; // skips blanks + `# comments`
+        let val = m[2];
+        if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'")))
+            val = val.slice(1, -1);
+        if (process.env[m[1]] === undefined)
+            process.env[m[1]] = val;
+    }
+}
 // Locate a project folder when none is given: check the dir, its ./agentic-surfaces
 // subfolder (the repo-native convention), then walk up. Lets `agentic-surfaces`
 // be run bare from a repo root and still find the config.
@@ -122,6 +142,7 @@ function findProjectConfig(startDir) {
     }
 }
 export async function run(argv) {
+    loadDotenv(); // pick up a .env (cwd) for secrets — optional; Doppler / real env override it
     const [cmd, ...rest] = argv;
     try {
         // Default / `ui`: launch the visual control surface. `agentic-surfaces`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/cli",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -18,13 +18,27 @@
     "flow": "dist/bin.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "dependencies": {
-    "@agentic-surfaces/core": "0.1.23",
-    "@agentic-surfaces/agent": "0.1.23",
-    "@agentic-surfaces/server": "0.1.23"
+    "@agentic-surfaces/core": "0.1.24",
+    "@agentic-surfaces/agent": "0.1.24",
+    "@agentic-surfaces/server": "0.1.24"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dalebaldwin/agentic-surfaces.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/dalebaldwin/agentic-surfaces#readme",
+  "bugs": "https://github.com/dalebaldwin/agentic-surfaces/issues",
+  "keywords": [
+    "agentic-surfaces",
+    "workflow",
+    "ai-agents",
+    "claude"
+  ],
   "scripts": {
     "build": "tsc -b",
     "test": "vitest run --root ../.."