@fieldwork-ai/cli 0.16.0 → 0.17.2

package/README.md

@@ -62,3 +62,7 @@ claude mcp add --transport http fieldwork https://app.getfieldwork.ai/mcp
 Source stays in the private app repository under `cli/`. Run `pnpm install --frozen-lockfile`, `pnpm build`, and `pnpm test` here. Publish the compiled package with `npm publish --access public`; the package includes `dist/` and npm metadata, without TypeScript source or source maps. `scripts/pack-cli.sh` builds and packs this same package into the compute image without depending on an npm release.
 
 The terminal chat client is the separate public `@fieldwork-ai/fieldwork-code` package (`fwcode`).
+
+## Graph authoring diagnostics
+
+Use `fieldwork tool run automations_graph_examples --json` for executable examples and the coordinated code/graph publication format. `automations_graph_validate` takes the publication input without committing it. `automations_graph_test` uses isolated editable-table fixtures and captured notifications; it does not execute authored code or send email. `automations_graph_wait` returns bounded, compact progress, and `automations_graph_trace` accepts `detail: "full"` when saved payloads are needed. Contract failures include source/destination paths, required coordinated changes and retryability on stderr with a nonzero exit code.

package/dist/commands/automations.js

@@ -1,6 +1,7 @@
+import { readFile } from "node:fs/promises";
 import { api, apiJson, getContext, requireOrgId } from "../http.js";
 import { EXIT, confirm, exitCodeFor, fail, note, printData } from "../output.js";
-const TERMINAL_STATUSES = new Set(["succeeded", "failed"]);
+const TERMINAL_STATUSES = new Set(["succeeded", "failed", "cancelled", "needs_attention"]);
 async function resolveAutomation(name) {
     const body = await apiJson(`/api/organizations/${requireOrgId()}/automations?name=${encodeURIComponent(name)}`);
     const automation = body.automations?.[0];
@@ -70,6 +71,24 @@ async function followRun(automationId, runId, intervalSeconds, json) {
     }
 }
 export function registerAutomationCommands(program) {
+    const graph = program.command("automation-graph").description("Publish and inspect automation graphs");
+    graph.command("get <automation-id>").action(async (id) => printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/graph`), true));
+    graph.command("trace <automation-id> <run-id>").action(async (id, runId) => printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/runs/${encodeURIComponent(runId)}/steps`), true));
+    graph.command("configure <automation-id>").requiredOption("--file <path>").action(async (id, options) => {
+        const body = await readFile(options.file, "utf8");
+        await confirm("Apply these triggers and enabled state?", getContext().yes);
+        printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/graph`, { method: "PATCH", body }), true);
+    });
+    graph.command("control <automation-id> <run-id>").requiredOption("--file <path>", "Cancel, retry, or confirmed reconciliation").action(async (id, runId, options) => {
+        const body = await readFile(options.file, "utf8");
+        await confirm("Apply this run control? Confirm external results before reconciliation.", getContext().yes);
+        printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/runs/${encodeURIComponent(runId)}/steps`, { method: "POST", body }), true);
+    });
+    graph.command("publish").requiredOption("--file <path>").action(async (options) => {
+        const body = await readFile(options.file, "utf8");
+        await confirm("Publish this graph and delegate its listed resource access?", getContext().yes);
+        printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/graphs`, { method: "POST", body }), true);
+    });
     const automations = program
         .command("automations")
         .description("Standing instructions that run unattended (schedules, webhooks)");

package/dist/commands/tables.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function tablesCommand(): Command;

package/dist/commands/tables.js

@@ -0,0 +1,41 @@
+import { readFile } from "node:fs/promises";
+import { Command } from "commander";
+import { apiJson, requireOrgId, getContext } from "../http.js";
+import { confirm, printData } from "../output.js";
+export function tablesCommand() {
+    const command = new Command("tables").description("Fieldwork Tables and editable records");
+    const base = () => `/api/organizations/${requireOrgId()}/tables`;
+    command
+        .command("list")
+        .action(async () => printData(await apiJson(base()), true));
+    command
+        .command("create")
+        .requiredOption("--file <path>", "Table definition file")
+        .action(async (options) => {
+        const body = await readFile(options.file, "utf8");
+        await confirm("Create this Fieldwork Table?", getContext().yes);
+        printData(await apiJson(base(), { method: "POST", body }), true);
+    });
+    command
+        .command("records <table-id>")
+        .option("--after <id>")
+        .option("--limit <number>", "Page size", "50")
+        .action(async (tableId, options) => {
+        const query = new URLSearchParams({ limit: options.limit });
+        if (options.after)
+            query.set("after", options.after);
+        printData(await apiJson(`${base()}/${encodeURIComponent(tableId)}/records?${query}`), true);
+    });
+    command
+        .command("mutate <table-id>")
+        .requiredOption("--file <path>", "Record mutation file")
+        .action(async (tableId, options) => {
+        const body = await readFile(options.file, "utf8");
+        await confirm("Apply this record mutation?", getContext().yes);
+        printData(await apiJson(`${base()}/${encodeURIComponent(tableId)}/records`, {
+            method: "POST",
+            body,
+        }), true);
+    });
+    return command;
+}

package/dist/http.js

@@ -114,7 +114,25 @@ export async function apiJson(pathname, init = {}) {
     const res = await api(pathname, init);
     const body = (await res.json().catch(() => null));
     if (!res.ok) {
-        fail(body?.error ?? `request failed (${res.status})`, exitCodeFor(res.status));
+        const message = body?.error ?? `request failed (${res.status})`;
+        const details = Array.isArray(body?.details) ? body.details.flatMap((issue) => {
+            if (!issue || typeof issue !== "object")
+                return [];
+            const { path, message } = issue;
+            return typeof message === "string" ? [`${Array.isArray(path) ? path.join(".") + ": " : ""}${message}`] : [];
+        }) : [];
+        if (body?.code === "invalid_graph" && body.details && typeof body.details === "object" && !Array.isArray(body.details)) {
+            const diagnostic = body.details;
+            for (const key of ["action_definition_id", "automation_id", "automation_revision_id", "node_id", "source", "destination", "input", "output", "source_schema", "target_schema", "effect_changed", "credential_changed", "required_action"]) {
+                const value = diagnostic[key];
+                if (value !== undefined && value !== null)
+                    details.push(`${key}: ${typeof value === "string" ? value : JSON.stringify(value)}`);
+            }
+            if (typeof body.retryable === "boolean")
+                details.push(`retryable: ${body.retryable}`);
+        }
+        const prefix = typeof body?.tool === "string" ? `${body.tool}: ` : "";
+        fail([prefix + message, ...details].join("\n"), exitCodeFor(res.status));
     }
     return body;
 }

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { tablesCommand } from "./commands/tables.js";
 import { Command } from "commander";
 import { createRequire } from "node:module";
 import { initContext } from "./http.js";
@@ -40,6 +41,7 @@ registerAppCommands(program);
 registerAutomationCommands(program);
 registerTaskCommands(program);
 registerConnectorCommands(program);
+program.addCommand(tablesCommand());
 program.parseAsync(process.argv).catch((err) => {
     process.stderr.write(`fieldwork: ${err instanceof Error ? err.message : String(err)}\n`);
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldwork-ai/cli",
-  "version": "0.16.0",
+  "version": "0.17.2",
   "description": "Fieldwork asset-management CLI",
   "license": "UNLICENSED",
   "type": "module",
@@ -13,6 +13,12 @@
   "engines": {
     "node": ">=24"
   },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', {recursive:true,force:true})\" && tsc",
+    "prepack": "pnpm build",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run"
+  },
   "dependencies": {
     "commander": "^14.0.2"
   },
@@ -30,10 +36,5 @@
   "exports": {
     "./package.json": "./package.json",
     "./*": "./dist/*.js"
-  },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', {recursive:true,force:true})\" && tsc",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run"
   }
-}
+}