@boardwalk-labs/cli 0.1.0

package/dist/deployment.js

@@ -0,0 +1,100 @@
+// Shared deploy logic for `boardwalk deploy` and `boardwalk run`.
+//
+// Deploy is artifact-based: build the program into a content-addressed tarball, upload it straight
+// to object storage via a presigned PUT (the CLI holds no storage credentials), then finalize the
+// version with a reference the server re-reads + verifies. Identity is the project LINK
+// (.boardwalk/project.json), not the program name. Both commands:
+//   1. build the program artifact (name from its `meta`),
+//   2. resolve the org (--org, else the link's orgSlug),
+//   3. upload the artifact, then update the linked workflow BY ID (rename-safe) — or, when unlinked,
+//      adopt an existing same-name workflow / create a new one — then (re)write the link.
+import { CliError } from "./errors.js";
+import { extractWorkflowName } from "./manifest.js";
+import { buildArtifact } from "./artifact.js";
+import { projectDirFor, readLink, writeLink } from "./project.js";
+/**
+ * Resolve a target path to its deployable artifact: build the program (bundle + assets → tarball,
+ * content-addressed) and extract `meta.name` from the bundled entry for the deploy identity.
+ */
+export async function loadProgram(file) {
+    const artifact = await buildArtifact(file);
+    const name = extractWorkflowName(artifact.entrySource, artifact.entry);
+    return { name, entry: artifact.entry, artifact };
+}
+/** Decide create vs update by matching the program name against the org's existing workflows. */
+export function planDeploy(existing, name) {
+    const match = existing.find((w) => w.name === name);
+    return match !== undefined
+        ? { action: "update", name, workflowId: match.id }
+        : { action: "create", name };
+}
+/** The artifact reference recorded on the version (everything but the bytes, which go to storage). */
+function refOf(artifact) {
+    return {
+        digest: artifact.digest,
+        size: artifact.size,
+        entry: artifact.entry,
+        sdkVersion: artifact.sdkVersion,
+        lockfileDigest: artifact.lockfileDigest,
+    };
+}
+/**
+ * Deploy the program, honoring the project link: upload the artifact, then update the linked workflow
+ * by id (rename-safe); when unlinked, adopt an existing same-name workflow or create a new one. Always
+ * (re)writes the link so the next deploy/run is pinned.
+ */
+export async function deployWithLink(client, ctx) {
+    const projectDir = projectDirFor(ctx.target);
+    const link = readLink(projectDir);
+    const orgSlug = ctx.orgSlug ?? link?.orgSlug;
+    if (orgSlug === undefined || orgSlug.length === 0) {
+        throw new CliError("No org to deploy into.", "Pass --org <slug> (it'll be linked in .boardwalk/project.json for next time).");
+    }
+    let workflowId = link?.workflowId ?? null;
+    let outcome = "updated";
+    // Unlinked: adopt an existing workflow with the same name, if any (so a second machine re-links
+    // instead of creating a duplicate). Otherwise we'll create below.
+    if (workflowId === null) {
+        const match = (await client.listWorkflows(orgSlug)).find((w) => w.name === ctx.prog.name);
+        if (match !== undefined) {
+            workflowId = match.id;
+            outcome = "adopted";
+        }
+    }
+    // Upload the artifact bytes once (presigned PUT); both create + update reference it by digest.
+    const { artifact } = ctx.prog;
+    const { uploadUrl, contentType } = await client.getArtifactUploadUrl(orgSlug, {
+        digest: artifact.digest,
+        size: artifact.size,
+    });
+    await client.uploadArtifact(uploadUrl, contentType, artifact.tarball);
+    const ref = refOf(artifact);
+    let versionNumber;
+    if (workflowId !== null) {
+        try {
+            const result = await client.updateWorkflow(workflowId, ref);
+            versionNumber = result.version.number;
+        }
+        catch (err) {
+            if (err instanceof CliError && err.status === 404) {
+                // The linked workflow was deleted out from under us — recreate + relink.
+                const result = await client.createWorkflow(orgSlug, ref);
+                workflowId = result.workflow.id;
+                versionNumber = result.version.number;
+                outcome = "created";
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    else {
+        const result = await client.createWorkflow(orgSlug, ref);
+        workflowId = result.workflow.id;
+        versionNumber = result.version.number;
+        outcome = "created";
+    }
+    const { gitignoreUpdated } = writeLink(projectDir, { orgSlug, workflowId });
+    return { workflowId, orgSlug, versionNumber, outcome, gitignoreUpdated };
+}
+//# sourceMappingURL=deployment.js.map

package/dist/deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../src/deployment.ts"],"names":[],"mappings":"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"}

package/dist/dev/host.d.ts

@@ -0,0 +1,16 @@
+import type { WorkflowManifest } from "@boardwalk-labs/workflow";
+import type { WorkflowHost } from "@boardwalk-labs/workflow/runtime";
+import type { RunEvent } from "@boardwalk-labs/workflow";
+/** A run event minus its envelope — the emitter (dev.ts) stamps runId/turnId/seq/t. */
+export type RunEventBody = RunEvent extends infer E ? E extends RunEvent ? Omit<E, "runId" | "turnId" | "seq" | "t"> : never : never;
+export interface DevHostContext {
+    manifest: WorkflowManifest;
+    /** Parsed env file contents — the local secret store. */
+    envVars: ReadonlyMap<string, string>;
+    /** The env file path, for actionable error messages (never its contents). */
+    envLabel: string;
+    /** Directory artifacts are written under (created lazily). */
+    artifactsDir: string;
+    emit: (body: RunEventBody) => void;
+}
+export declare function createDevHost(ctx: DevHostContext): WorkflowHost;

package/dist/dev/host.js

@@ -0,0 +1,76 @@
+// The `boardwalk dev` WorkflowHost — the minimal embedded host backing a one-off local run.
+//
+// Scope (v0.1, until `@boardwalk-labs/engine` ships and `dev` delegates to its embedded mode):
+//   - secrets resolve from the project's env file (fail-closed against `meta.secrets`)
+//   - sleep really sleeps (hold-and-pay semantics: locals survive, the process waits)
+//   - Phase() markers and output() flow into the run-event stream
+//   - artifacts write under `.bw-runs/<runId>/artifacts/`
+//   - agent() and workflows.call() fail with a clear pointer at what supports them
+//
+// Secret VALUES never reach the event stream or any error message.
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { CliError } from "../errors.js";
+export function createDevHost(ctx) {
+    let phaseCount = 0;
+    let artifactCount = 0;
+    return {
+        setPhase(name, opts) {
+            phaseCount += 1;
+            ctx.emit({ kind: "phase", name, id: opts?.id ?? `phase-${String(phaseCount)}` });
+        },
+        agent() {
+            throw new CliError("agent() isn't available in `boardwalk dev` yet.", "The embedded local engine ships with @boardwalk-labs/engine — until then, deploy and use " +
+                "`boardwalk run` to execute agent loops.");
+        },
+        callWorkflow() {
+            throw new CliError("workflows.call() isn't available in `boardwalk dev` — durable child runs need an engine.", "Deploy and use `boardwalk run`, or run the callee directly with `boardwalk dev <its file>`.");
+        },
+        async sleep(arg) {
+            const ms = sleepMs(arg);
+            if (ms <= 0)
+                return;
+            await new Promise((resolve) => {
+                setTimeout(resolve, ms);
+            });
+        },
+        getSecret(name) {
+            const declared = (ctx.manifest.secrets ?? []).some((s) => s.name === name);
+            if (!declared) {
+                throw new CliError(`Secret "${name}" is not declared in meta.secrets.`, `Add { name: "${name}" } to meta.secrets — secret access is fail-closed everywhere.`);
+            }
+            const value = ctx.envVars.get(name) ?? process.env[name];
+            if (value === undefined || value.length === 0) {
+                throw new CliError(`Secret "${name}" has no value for this local run.`, `Set ${name}=… in ${ctx.envLabel} (boardwalk dev resolves secrets from your env file).`);
+            }
+            return Promise.resolve(value);
+        },
+        writeArtifact(name, _contentType, body, _metadata) {
+            if (name.includes("/") || name.includes("\\") || name.includes("..")) {
+                throw new CliError(`Artifact name "${name}" must be a plain file name.`);
+            }
+            mkdirSync(ctx.artifactsDir, { recursive: true });
+            const path = join(ctx.artifactsDir, name);
+            writeFileSync(path, body);
+            artifactCount += 1;
+            return Promise.resolve({
+                id: `art-${String(artifactCount)}`,
+                name,
+                url: pathToFileURL(path).href,
+            });
+        },
+    };
+}
+function sleepMs(arg) {
+    if (typeof arg === "number")
+        return arg;
+    if ("durationMs" in arg)
+        return arg.durationMs;
+    const until = arg.until instanceof Date ? arg.until.getTime() : Date.parse(arg.until);
+    if (Number.isNaN(until)) {
+        throw new CliError(`sleep({ until }) got an unparseable date: ${String(arg.until)}`);
+    }
+    return until - Date.now();
+}
+//# sourceMappingURL=host.js.map

package/dist/dev/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/dev/host.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class CliError extends Error {
+    readonly hint: string | undefined;
+    /** HTTP status, when this error came from an API response (lets callers branch on e.g. 404). */
+    readonly status: number | undefined;
+    /** Process exit code override (default 1) — e.g. 130 for a cancelled `dev` run. */
+    readonly exitCode: number | undefined;
+    constructor(message: string, hint?: string, status?: number, exitCode?: number);
+}

package/dist/errors.js

@@ -0,0 +1,18 @@
+// CliError — a user-facing error. The top-level handler prints `message` (and `hint`, if any) to
+// stderr and exits non-zero, WITHOUT a stack trace. Throw this for expected failures (not
+// authenticated, file missing, API rejected the request); let unexpected errors surface their stack.
+export class CliError extends Error {
+    hint;
+    /** HTTP status, when this error came from an API response (lets callers branch on e.g. 404). */
+    status;
+    /** Process exit code override (default 1) — e.g. 130 for a cancelled `dev` run. */
+    exitCode;
+    constructor(message, hint, status, exitCode) {
+        super(message);
+        this.name = "CliError";
+        this.hint = hint;
+        this.status = status;
+        this.exitCode = exitCode;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,0FAA0F;AAC1F,qGAAqG;AAErG,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAqB;IAClC,gGAAgG;IACvF,MAAM,CAAqB;IACpC,mFAAmF;IAC1E,QAAQ,CAAqB;IAEtC,YAAY,OAAe,EAAE,IAAa,EAAE,MAAe,EAAE,QAAiB;QAC5E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,147 @@
+// boardwalk CLI entrypoint — argument parsing + command dispatch (commander).
+//
+// Commands:
+//   boardwalk init [dir]                Scaffold a new workflow project from a template.
+//   boardwalk dev <file>                Run the workflow now, locally — no account needed.
+//   boardwalk check <file>              Validate a workflow locally (no auth/network).
+//   boardwalk login                     Authenticate via browser (OAuth PKCE).
+//   boardwalk logout                    Remove local credentials.
+//   boardwalk whoami                    Show the current session.
+//   boardwalk deploy <file> --org <s>   Create/update a workflow from a program file.
+//   boardwalk run <file> --org <s>      Deploy + trigger a real run, wait for the result.
+//   boardwalk cancel <runId>            Cancel a queued or in-flight run.
+//
+// Auth precedence for deploy/run/cancel: --token > BOARDWALK_API_KEY env > stored `login` session.
+//
+// Every command body is lazy-imported inside its action — `boardwalk --help` must stay fast, so
+// nothing heavy (esbuild, the SDK extractor, the API client) loads until its command actually runs.
+import { Command } from "commander";
+import { CliError } from "./errors.js";
+import { loadConfig } from "./config.js";
+const VERSION = "0.1.0";
+function buildProgram() {
+    const program = new Command();
+    program
+        .name("boardwalk")
+        .description("Boardwalk CLI — author and ship agent workflows.")
+        .version(VERSION);
+    program
+        .command("init")
+        .argument("[dir]", "directory to scaffold into (created if missing)", ".")
+        .option("--template <name>", "template: the built-in `hello`, or any name from the examples registry", "hello")
+        .description("Scaffold a new workflow project from a template.")
+        .action(async (dir, options) => {
+        const { runInit } = await import("./commands/init.js");
+        await runInit({ dir, template: options.template ?? "hello" });
+    });
+    program
+        .command("dev")
+        .argument("<file>", "workflow program file, or a package directory")
+        .option("--input <json>", "trigger payload exposed to the program as `input`")
+        // Named --env (not --env-file): Node ≥26 claims --env-file even after the script path,
+        // so that spelling would be processed (or rejected) by node itself before we ever parse it.
+        .option("--env <path>", "env file resolving secrets for the run (default: .env)")
+        .option("--verbose", "stream every event channel (agent turns, tool calls, logs)", false)
+        .option("--stream <channels>", "comma-separated channels: lifecycle,phase,output,log,agent")
+        .description("Run the workflow now, locally — no account needed.")
+        .action(async (file, options) => {
+        const { runDev } = await import("./commands/dev.js");
+        await runDev({
+            file,
+            input: options.input,
+            envFile: options.env,
+            verbose: options.verbose ?? false,
+            stream: options.stream,
+        });
+    });
+    program
+        .command("check")
+        .argument("<file>", "workflow program file, or a package directory")
+        .description("Validate a workflow locally (no auth, no network).")
+        .action(async (file) => {
+        const { runCheck } = await import("./commands/check.js");
+        await runCheck({ file });
+    });
+    program
+        .command("login")
+        .description("Authenticate via browser (OAuth PKCE), or store an API key with --token.")
+        .option("--token <key>", "store this API key (bwk_…) instead of the browser flow")
+        .action(async (options) => {
+        const { runLogin } = await import("./commands/session.js");
+        await runLogin({ config: loadConfig() }, { token: options.token });
+    });
+    program
+        .command("logout")
+        .description("Remove local credentials.")
+        .action(async () => {
+        const { runLogout } = await import("./commands/session.js");
+        runLogout({ config: loadConfig() });
+    });
+    program
+        .command("whoami")
+        .description("Show the current session.")
+        .action(async () => {
+        const { runWhoami } = await import("./commands/session.js");
+        runWhoami({ config: loadConfig() });
+    });
+    program
+        .command("deploy")
+        .argument("<file>", "workflow program file, or a package directory")
+        .option("--org <slug>", "the org to deploy into (optional once the project is linked)")
+        .option("--dry-run", "print the plan (create vs update) without writing", false)
+        .option("--token <token>", "use this Bearer token instead of stored/env credentials")
+        .description("Create or update a workflow from a program file.")
+        .action(async (file, options) => {
+        const { runDeploy } = await import("./commands/deploy.js");
+        await runDeploy({
+            file,
+            org: options.org,
+            check: options.dryRun ?? false,
+            token: options.token,
+        }, { config: loadConfig() });
+    });
+    program
+        .command("run")
+        .argument("<file>", "workflow program file, or a package directory")
+        .option("--org <slug>", "the org to run in (optional once the project is linked)")
+        .option("--input <json>", "trigger payload exposed to the program as `input`")
+        .option("--no-wait", "trigger and exit without waiting for the run to finish")
+        .option("--token <token>", "use this Bearer token instead of stored/env credentials")
+        .description("Deploy the program, trigger a real run, and wait for the result.")
+        .action(async (file, options) => {
+        const { runRun } = await import("./commands/run.js");
+        await runRun({
+            file,
+            org: options.org,
+            input: options.input,
+            noWait: options.wait === false,
+            token: options.token,
+        }, { config: loadConfig() });
+    });
+    program
+        .command("cancel")
+        .argument("<runId>", "the run to cancel")
+        .option("--token <token>", "use this Bearer token instead of stored/env credentials")
+        .description("Cancel a queued or in-flight run.")
+        .action(async (runId, options) => {
+        const { runCancel } = await import("./commands/cancel.js");
+        await runCancel({ runId, token: options.token }, { config: loadConfig() });
+    });
+    return program;
+}
+async function main() {
+    await buildProgram().parseAsync(process.argv);
+}
+main().catch((err) => {
+    if (err instanceof CliError) {
+        console.error(`error: ${err.message}`);
+        if (err.hint !== undefined)
+            console.error(`  ${err.hint}`);
+        process.exitCode = err.exitCode ?? 1;
+    }
+    else {
+        console.error(err);
+        process.exitCode = 1;
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,12 @@
+import { type WorkflowManifest } from "@boardwalk-labs/workflow";
+/**
+ * Statically read `export const meta = { name: "...", ... }` and return the name string.
+ * Throws `CliError` when there is no pure-literal `meta` or `name` is missing/empty/not a string.
+ */
+export declare function extractWorkflowName(source: string, fileName?: string): string;
+/**
+ * Statically extract `meta` and validate it against the manifest schema (the same one every
+ * engine consumes), returning the fully-defaulted manifest. Throws `CliError` with the precise
+ * extraction or per-field validation failure.
+ */
+export declare function extractValidatedManifest(source: string, fileName?: string): WorkflowManifest;

package/dist/manifest.js

@@ -0,0 +1,64 @@
+// Manifest extraction for CLI commands — thin wrappers over `@boardwalk-labs/workflow/extract`,
+// translating extraction/validation failures into actionable `CliError`s.
+//
+// Two tiers, on purpose:
+//   - `extractWorkflowName` — name only. `deploy`/`run` need the deploy identity (create-vs-update
+//     is matched by NAME, which is environment-independent, unlike a path or stored id); the server
+//     re-derives and validates the FULL manifest from the uploaded source, so the CLI doesn't
+//     pre-judge field-level validity on the way to a deploy.
+//   - `extractValidatedManifest` — the full schema. `check` and `dev` run entirely locally, so they
+//     ARE the validator: same extractor, same schema, same errors as every engine.
+//
+// Pure logic; the program is never executed.
+import { extractManifest, extractMetaLiteral, MetaExtractionError, } from "@boardwalk-labs/workflow/extract";
+import { MetaValidationError } from "@boardwalk-labs/workflow";
+import { CliError } from "./errors.js";
+/**
+ * Statically read `export const meta = { name: "...", ... }` and return the name string.
+ * Throws `CliError` when there is no pure-literal `meta` or `name` is missing/empty/not a string.
+ */
+export function extractWorkflowName(source, fileName = "index.ts") {
+    const meta = extractLiteralOrThrow(source, fileName);
+    const name = meta.name;
+    if (name !== undefined && typeof name !== "string") {
+        throw new CliError("`meta.name` must be a plain string literal.");
+    }
+    const trimmed = typeof name === "string" ? name.trim() : "";
+    if (trimmed.length === 0) {
+        throw new CliError("`meta.name` is missing or empty.", "Give the workflow a stable name — it's the deploy identity used to match create vs update.");
+    }
+    return trimmed;
+}
+/**
+ * Statically extract `meta` and validate it against the manifest schema (the same one every
+ * engine consumes), returning the fully-defaulted manifest. Throws `CliError` with the precise
+ * extraction or per-field validation failure.
+ */
+export function extractValidatedManifest(source, fileName = "index.ts") {
+    try {
+        return extractManifest(source, { fileName });
+    }
+    catch (err) {
+        if (err instanceof MetaExtractionError) {
+            throw new CliError(err.message, META_HINT);
+        }
+        if (err instanceof MetaValidationError) {
+            throw new CliError(err.message);
+        }
+        throw err;
+    }
+}
+const META_HINT = "A workflow program must export a pure-literal `export const meta = { … }` " +
+    "(no spreads, calls, or interpolation — engines read it without executing your code).";
+function extractLiteralOrThrow(source, fileName) {
+    try {
+        return extractMetaLiteral(source, { fileName });
+    }
+    catch (err) {
+        if (err instanceof MetaExtractionError) {
+            throw new CliError(err.message, META_HINT);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,0EAA0E;AAC1E,EAAE;AACF,yBAAyB;AACzB,mGAAmG;AACnG,oGAAoG;AACpG,8FAA8F;AAC9F,6DAA6D;AAC7D,oGAAoG;AACpG,mFAAmF;AACnF,EAAE;AACF,6CAA6C;AAE7C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAyB,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,QAAQ,GAAG,UAAU;IACvE,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,QAAQ,CAAC,6CAA6C,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,QAAQ,CAChB,kCAAkC,EAClC,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,QAAQ,GAAG,UAAU;IAC5E,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;YACvC,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;YACvC,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GACb,4EAA4E;IAC5E,sFAAsF,CAAC;AAEzF,SAAS,qBAAqB,CAAC,MAAc,EAAE,QAAgB;IAC7D,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;YACvC,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,15 @@
+export interface ProjectLink {
+    orgSlug: string;
+    workflowId: string;
+}
+/** The project directory for a target path: the directory itself, or a file's parent directory. */
+export declare function projectDirFor(target: string): string;
+/** Read the link for a project dir, or null when absent/malformed. */
+export declare function readLink(projectDir: string): ProjectLink | null;
+/**
+ * Persist the link and ensure `.boardwalk/` is gitignored. Returns true if it added a `.gitignore`
+ * entry (so the caller can mention it). Best-effort on the gitignore side — never fatal.
+ */
+export declare function writeLink(projectDir: string, link: ProjectLink): {
+    gitignoreUpdated: boolean;
+};

package/dist/project.js

@@ -0,0 +1,79 @@
+// Project link — the Vercel-style tie between a local workflow directory and its deployed workflow.
+//
+// `<projectDir>/.boardwalk/project.json` (gitignored) stores `{ orgSlug, workflowId }`. Once linked,
+// `deploy`/`run` update the workflow BY ID — so renaming `meta.name` (or the entry file) just
+// updates the same workflow instead of forking a new one, and `--org` is no longer needed. The id is
+// environment-specific (a dev workflow id ≠ prod), so the link is gitignored, not committed.
+//
+// One workflow per project directory (the "a workflow is a package with an index entry" model). The
+// project dir is the directory target itself, or the directory containing a single-file entry.
+import { mkdirSync, readFileSync, writeFileSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+const LINK_DIR = ".boardwalk";
+const LINK_FILE = "project.json";
+/** The project directory for a target path: the directory itself, or a file's parent directory. */
+export function projectDirFor(target) {
+    const abs = resolve(target);
+    try {
+        if (statSync(abs).isDirectory())
+            return abs;
+    }
+    catch {
+        // Missing path — treat the target as a file and use its parent.
+    }
+    return dirname(abs);
+}
+/** Read the link for a project dir, or null when absent/malformed. */
+export function readLink(projectDir) {
+    let raw;
+    try {
+        raw = readFileSync(join(projectDir, LINK_DIR, LINK_FILE), "utf8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === "object" && parsed !== null) {
+            const p = parsed;
+            if (typeof p.orgSlug === "string" && typeof p.workflowId === "string") {
+                return { orgSlug: p.orgSlug, workflowId: p.workflowId };
+            }
+        }
+    }
+    catch {
+        // Malformed → treat as unlinked.
+    }
+    return null;
+}
+/**
+ * Persist the link and ensure `.boardwalk/` is gitignored. Returns true if it added a `.gitignore`
+ * entry (so the caller can mention it). Best-effort on the gitignore side — never fatal.
+ */
+export function writeLink(projectDir, link) {
+    const dir = join(projectDir, LINK_DIR);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, LINK_FILE), `${JSON.stringify(link, null, 2)}\n`);
+    return { gitignoreUpdated: ensureGitignored(projectDir) };
+}
+function ensureGitignored(projectDir) {
+    const gitignore = join(projectDir, ".gitignore");
+    let content = "";
+    try {
+        content = readFileSync(gitignore, "utf8");
+    }
+    catch {
+        // No .gitignore yet — we'll create one.
+    }
+    if (/^\.boardwalk\/?\s*$/m.test(content))
+        return false;
+    const prefix = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+    try {
+        writeFileSync(gitignore, `${content}${prefix}.boardwalk/\n`);
+        return true;
+    }
+    catch {
+        return false; // best-effort: a read-only dir shouldn't break deploy
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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"}

package/dist/render/renderer.d.ts

@@ -0,0 +1,18 @@
+import { type Channel, type RunEvent } from "@boardwalk-labs/workflow";
+export interface ChannelFlags {
+    /** `--verbose`: subscribe to every channel. */
+    verbose: boolean;
+    /** `--stream <channels>`: explicit comma-separated channel list. */
+    stream?: string | undefined;
+}
+/** Resolve `--verbose` / `--stream` to a channel subscription (default: lifecycle+phase+output). */
+export declare function parseChannels(flags: ChannelFlags): readonly Channel[];
+export interface EventRenderer {
+    /** Render one event to the writer iff it matches the subscription. */
+    render(event: RunEvent): void;
+}
+/**
+ * Build the renderer. `write` receives raw text (newlines included where intended) — pass
+ * `process.stdout.write` in the CLI, an accumulator in tests.
+ */
+export declare function createRenderer(channels: readonly Channel[], write: (text: string) => void): EventRenderer;