@roarkanalytics/cli 0.1.0 → 0.2.0

package/man/roark-config-apply.1

@@ -1,28 +1,33 @@
-.\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
+.\" Hand-maintained. `config apply` is a hand-written command
+.\" (packages/cli/src/runtime/commands/config-as-code.ts): `program.ts` filters the
+.\" generated one out, so this page documents the runtime, not the endpoint.
+.\" sdk.yml lists it under targets.cli.hand_maintained_commands, which is what stops
+.\" app-agent-codegen regenerating this file. Removing that entry silently clobbers it.
 .TH "ROARK\-CONFIG\-APPLY" "1" "" "roark-config-apply" "Roark Analytics API Manual"
 .SH "NAME"
-roark\-config\-apply \- Apply a config bundle
+roark\-config\-apply \- Reconcile the project to a config-as-code directory
 .SH "SYNOPSIS"
 .B roark config apply
 [\fIoptions\fR]
+[\fIdir\fR]
 .SH "DESCRIPTION"
-Reconcile a config\-as\-code bundle into the project. Submit the full desired set of resources; resources already managed by config are updated, new ones created, and (unless prune is false) config\-managed resources absent from the bundle are deleted. Identity is by name — no ids in the bundle.
-.SH "API"
-POST /v1/config/apply
-.SH "OPTIONS"
-.TP
-\fB\-\-resources\fR \fI<value>\fR
-Required.
+Build a config-as-code bundle from a directory of YAML files and reconcile the project to it: resources already managed by config are updated, new ones created, and (unless \fB\-\-no\-prune\fR) config-managed resources absent from the bundle are deleted. Identity is by name (no ids in the bundle).
+.PP
+It first previews the diff and asks to confirm before writing, so a prune-driven delete is never a surprise. Pass \fB\-\-yes\fR to skip the prompt (e.g. in CI). Point it at a config directory (reads \fB*.yaml\fR / \fB*.yml\fR, inlines \fBfile://\fR references), or supply a pre-built bundle with \fB\-\-data\fR / stdin.
+.SH "ARGUMENTS"
 .TP
-\fB\-\-prune\fR
-Optional.
-.SH "GLOBAL OPTIONS"
+\fIdir\fR
+A directory of config resources (\fB*.yaml\fR). Omit it to supply a pre-built bundle with \fB\-\-data\fR or on stdin instead.
+.SH "OPTIONS"
 .TP
 \fB\-\-data\fR \fI<json>\fR
-Request body as JSON, or @file to read one (@\- for stdin).
+Pre-built bundle as JSON, or @file (@\- for stdin); an alternative to a directory.
+.TP
+\fB\-\-no\-prune\fR
+Do not delete config-managed resources that are absent from the bundle.
 .TP
 \fB\-y\fR, \fB\-\-yes\fR
-Skip confirmation prompts.
+Skip the confirmation prompt.
 .TP
 \fB\-\-no\-input\fR
 Never prompt; fail instead.
@@ -47,17 +52,12 @@ Shorthand for \-\-format json.
 .TP
 \fB\-\-no\-color\fR
 Disable colour.
-.TP
-\fB\-q\fR, \fB\-\-quiet\fR
-Suppress non\-essential output.
-.TP
-\fB\-\-allow\-project\-base\-url\fR
-Send the stored credential to a base URL set by a project .roark.json. Refused by default.
 .SH "EXAMPLES"
 .PP
 .RS 4
 .nf
-roark config apply \-\-resources <value>
+roark config apply ./roark
+roark config apply ./roark \-\-yes \-\-no\-prune
 .fi
 .RE
 .SH "ENVIRONMENT"
@@ -68,9 +68,6 @@ Bearer token used when \-\-token is not given.
 \fBROARK_BASE_URL\fR
 API base URL.
 .TP
-\fBROARK_ALLOW_PROJECT_BASE_URL\fR
-Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
-.TP
 \fBNO_COLOR\fR
 Disables colour when set to any value.
 .SH "EXIT STATUS"
@@ -83,14 +80,6 @@ The API rejected the request.
 .TP
 \fB2\fR
 The command line was wrong.
-.TP
-\fB3\fR
-No credential, or the credential was refused.
-.TP
-\fB4\fR
-The addressed resource does not exist.
-.TP
-\fB5\fR
-The request never completed: connection, timeout, or abort.
 .SH "SEE ALSO"
-.BR roark (1)
+.BR roark (1),
+.BR roark-config-diff (1)

package/man/roark-config-diff.1

@@ -1,31 +1,30 @@
-.\" File generated from our OpenAPI spec by app-agent-codegen. Do not edit.
+.\" Hand-maintained. `config diff` is a hand-written command
+.\" (packages/cli/src/runtime/commands/config-as-code.ts): `program.ts` filters the
+.\" generated one out, so this page documents the runtime, not the endpoint.
+.\" sdk.yml lists it under targets.cli.hand_maintained_commands, which is what stops
+.\" app-agent-codegen regenerating this file. Removing that entry silently clobbers it.
 .TH "ROARK\-CONFIG\-DIFF" "1" "" "roark-config-diff" "Roark Analytics API Manual"
 .SH "NAME"
-roark\-config\-diff \- Diff a config bundle
+roark\-config\-diff \- Preview config-as-code changes
 .SH "SYNOPSIS"
 .B roark config diff
 [\fIoptions\fR]
+[\fIdir\fR]
 .SH "DESCRIPTION"
-Dry run: returns the changes reconcile a config\-as\-code bundle into the project. Submit the full desired set of resources; resources already managed by config are updated, new ones created, and (unless prune is false) config\-managed resources absent from the bundle are deleted. Identity is by name — no ids in the bundle. No writes are performed.
-.SH "API"
-POST /v1/config/diff
-.SH "OPTIONS"
-.TP
-\fB\-\-resources\fR \fI<value>\fR
-Required.
+Build a config-as-code bundle from a directory of YAML files and show the changes it would make against the project. No writes are performed.
+.PP
+Point it at a config directory and it reads every \fB*.yaml\fR / \fB*.yml\fR under it, inlines any \fBfile://\fR references, and submits the resulting bundle to \fBPOST /v1/config/diff\fR. The server computes the diff; identity is by name (no ids in the bundle). Run this before \fBconfig apply\fR to preview.
+.SH "ARGUMENTS"
 .TP
-\fB\-\-prune\fR
-Optional.
-.SH "GLOBAL OPTIONS"
+\fIdir\fR
+A directory of config resources (\fB*.yaml\fR). Omit it to supply a pre-built bundle with \fB\-\-data\fR or on stdin instead.
+.SH "OPTIONS"
 .TP
 \fB\-\-data\fR \fI<json>\fR
-Request body as JSON, or @file to read one (@\- for stdin).
-.TP
-\fB\-y\fR, \fB\-\-yes\fR
-Skip confirmation prompts.
+Pre-built bundle as JSON, or @file (@\- for stdin); an alternative to a directory.
 .TP
-\fB\-\-no\-input\fR
-Never prompt; fail instead.
+\fB\-\-no\-prune\fR
+Do not delete config-managed resources that are absent from the bundle.
 .TP
 \fB\-\-base\-url\fR \fI<url>\fR
 API base URL.
@@ -47,17 +46,12 @@ Shorthand for \-\-format json.
 .TP
 \fB\-\-no\-color\fR
 Disable colour.
-.TP
-\fB\-q\fR, \fB\-\-quiet\fR
-Suppress non\-essential output.
-.TP
-\fB\-\-allow\-project\-base\-url\fR
-Send the stored credential to a base URL set by a project .roark.json. Refused by default.
 .SH "EXAMPLES"
 .PP
 .RS 4
 .nf
-roark config diff \-\-resources <value>
+roark config diff ./roark
+cat bundle.json | roark config diff \-\-data @\-
 .fi
 .RE
 .SH "ENVIRONMENT"
@@ -68,9 +62,6 @@ Bearer token used when \-\-token is not given.
 \fBROARK_BASE_URL\fR
 API base URL.
 .TP
-\fBROARK_ALLOW_PROJECT_BASE_URL\fR
-Trusts a base URL set by a project .roark.json, like \-\-allow\-project\-base\-url.
-.TP
 \fBNO_COLOR\fR
 Disables colour when set to any value.
 .SH "EXIT STATUS"
@@ -83,14 +74,6 @@ The API rejected the request.
 .TP
 \fB2\fR
 The command line was wrong.
-.TP
-\fB3\fR
-No credential, or the credential was refused.
-.TP
-\fB4\fR
-The addressed resource does not exist.
-.TP
-\fB5\fR
-The request never completed: connection, timeout, or abort.
 .SH "SEE ALSO"
-.BR roark (1)
+.BR roark (1),
+.BR roark-config-apply (1)

package/man/roark-metric-definition-create.1

@@ -13,13 +13,13 @@ POST /v1/metric/definitions
 This endpoint accepts one of several request shapes, so the body is supplied as JSON through \e\-\e\-data or on standard input rather than as individual flags.
 .TP
 \fBPromptMetricInput\fR
-Requires calculationType, name, outputType, analysisPackageId.
+Requires calculationType, name, outputType.
 .TP
 \fBFormulaMetricInput\fR
-Requires calculationType, name, outputType, formula, sources, analysisPackageId.
+Requires calculationType, name, outputType, formula, sources.
 .TP
 \fBPatternMetricInput\fR
-Requires calculationType, name, operation, outcome, analysisPackageId.
+Requires calculationType, name, operation, outcome.
 .SH "GLOBAL OPTIONS"
 .TP
 \fB\-\-data\fR \fI<json>\fR

package/man/roark-simulation-persona-create.1

@@ -29,6 +29,9 @@ Languages the persona can understand. Defaults to the languages the persona spea
 \fB\-\-accent\fR \fI<value>\fR
 Accent of the persona, defined using ISO 3166\-1 alpha\-2 country codes with optional variants One of: US, US_X_SOUTH, GB, ES, DE, IN, FR, NL, SA, GR, AU, IT, ID, TH, JP, NZ, PH, SG, MY, HK, TR, PT, IL. Required.
 .TP
+\fB\-\-age\fR \fI<value>\fR
+How old the caller sounds and behaves. Only ages the persona's accent has a voice for are accepted; defaults to ADULT, which every accent supports. One of: CHILD, TEENAGER, ADULT, ELDERLY. Optional.
+.TP
 \fB\-\-gender\fR \fI<value>\fR
 Gender of the persona One of: MALE, FEMALE. Required.
 .TP

package/man/roark-simulation-persona-update.1

@@ -33,6 +33,9 @@ Languages the persona can understand. Multilingual combinations are limited by m
 \fB\-\-accent\fR \fI<value>\fR
 Accent of the persona, defined using ISO 3166\-1 alpha\-2 country codes with optional variants One of: US, US_X_SOUTH, GB, ES, DE, IN, FR, NL, SA, GR, AU, IT, ID, TH, JP, NZ, PH, SG, MY, HK, TR, PT, IL. Optional.
 .TP
+\fB\-\-age\fR \fI<value>\fR
+How old the caller sounds and behaves. Only ages the persona's accent has a voice for are accepted; defaults to ADULT, which every accent supports. One of: CHILD, TEENAGER, ADULT, ELDERLY. Optional.
+.TP
 \fB\-\-gender\fR \fI<value>\fR
 Gender of the persona One of: MALE, FEMALE. Optional.
 .TP

package/man/roark.1

@@ -103,10 +103,10 @@ List call sentiment runs See roark\-call\-sentiment\-run\-list(1).
 Get call transcript See roark\-call\-transcript\-get(1).
 .TP
 \fBroark config apply\fR
-Apply a config bundle See roark\-config\-apply(1).
+Reconcile the project to a config directory (or bundle). Previews and confirms first. See roark\-config\-apply(1).
 .TP
 \fBroark config diff\fR
-Diff a config bundle See roark\-config\-diff(1).
+Preview the changes a config directory (or bundle) would make. No writes. See roark\-config\-diff(1).
 .TP
 \fBroark customer\-flow create\fR
 Create a customer flow See roark\-customer\-flow\-create(1).

package/npm-shrinkwrap.json

@@ -0,0 +1,54 @@
+{
+  "name": "@roarkanalytics/cli",
+  "version": "0.2.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@roarkanalytics/cli",
+      "version": "0.2.0",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@roarkanalytics/sdk": "^3.2.0",
+        "commander": "^14.0.3",
+        "yaml": "^2.9.0"
+      },
+      "bin": {
+        "roark": "bin.js"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/@roarkanalytics/sdk": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/@roarkanalytics/sdk/-/sdk-3.2.0.tgz",
+      "integrity": "sha512-dZm7nhil+zSvh1jGWOp12znFbn1HYx5SocvzrDS82ljPQUATVqyLkloc0ANft3pSb3SiaaNuWd/Z46z912lTxg==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/commander": {
+      "version": "14.0.3",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz",
+      "integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/yaml": {
+      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz",
+      "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==",
+      "license": "ISC",
+      "bin": {
+        "yaml": "bin.mjs"
+      },
+      "engines": {
+        "node": ">= 14.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/eemeli"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roarkanalytics/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The official command line interface for the Roark API",
   "author": "Roark <james@roark.ai>",
   "type": "commonjs",
@@ -30,8 +30,9 @@
     "fix": "eslint --fix ."
   },
   "dependencies": {
-    "@roarkanalytics/sdk": "^2.33.0",
-    "commander": "^14.0.3"
+    "@roarkanalytics/sdk": "^3.2.0",
+    "commander": "^14.0.3",
+    "yaml": "^2.9.0"
   },
   "man": [
     "./man/roark.1",

package/runtime/commands/config-as-code.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `roark config diff [dir]` and `roark config apply [dir]` - config as code.
+ *
+ * These wrap the generated `config.diff` / `config.apply` SDK methods with the one client-side
+ * step they need to be useful: building the bundle from a directory of YAML files. Point either
+ * at a config directory and it reads `*.yaml`, inlines `file://` references, and submits the
+ * `{ resources, prune }` bundle. `--data`/stdin still take a pre-built bundle for scripting.
+ *
+ * `apply` previews the diff and asks to confirm before writing (config-managed resources absent
+ * from the bundle are deleted unless `--no-prune`), so a destructive apply is never a surprise.
+ * These replace the raw generated `config diff`/`apply` (excluded in program.ts) so there's one
+ * obvious way to run each.
+ */
+import { Command } from 'commander';
+import type Roark from '@roarkanalytics/sdk';
+import { type OutputFormat } from '../output';
+export declare const registerConfigAsCodeCommands: (root: Command, binaryName: string, clientFor: (options: never) => Roark, resolveOutput: (options: never) => {
+    format: OutputFormat;
+    color: boolean;
+}) => void;

package/runtime/commands/config-as-code.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * `roark config diff [dir]` and `roark config apply [dir]` - config as code.
+ *
+ * These wrap the generated `config.diff` / `config.apply` SDK methods with the one client-side
+ * step they need to be useful: building the bundle from a directory of YAML files. Point either
+ * at a config directory and it reads `*.yaml`, inlines `file://` references, and submits the
+ * `{ resources, prune }` bundle. `--data`/stdin still take a pre-built bundle for scripting.
+ *
+ * `apply` previews the diff and asks to confirm before writing (config-managed resources absent
+ * from the bundle are deleted unless `--no-prune`), so a destructive apply is never a surprise.
+ * These replace the raw generated `config diff`/`apply` (excluded in program.ts) so there's one
+ * obvious way to run each.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConfigAsCodeCommands = void 0;
+const commander_1 = require("commander");
+const confirm_1 = require("../confirm");
+const errors_1 = require("../errors");
+const input_1 = require("../input");
+const output_1 = require("../output");
+const config_bundle_1 = require("../config-bundle");
+const OP_MARK = { create: '+', update: '~', delete: '-', noop: ' ' };
+/** One-line-per-change summary for a terminal; `apply` results also carry a status. */
+const formatChanges = (data) => {
+    const lines = data.changes.map((change) => {
+        const mark = OP_MARK[String(change['op'])] ?? '?';
+        const status = change['status'] ? ` (${String(change['status'])})` : '';
+        const error = change['error'] ? `  ${String(change['error'])}` : '';
+        return `  ${mark} ${String(change['configKey'])}${status}${error}`;
+    });
+    const s = data.summary;
+    const tally = [
+        `${s['create'] ?? 0} to create`,
+        `${s['update'] ?? 0} to update`,
+        `${s['delete'] ?? 0} to delete`,
+        ...(s['failed'] === undefined ? [] : [`${s['failed']} failed`]),
+    ].join(', ');
+    return [...lines, '', tally].join('\n');
+};
+const changeCount = (summary) => (summary['create'] ?? 0) + (summary['update'] ?? 0) + (summary['delete'] ?? 0);
+/** Resolve the bundle: a directory (build it) or a pre-built bundle via --data / piped stdin. */
+const resolveBundle = async (dir, options) => {
+    const prune = options['prune'] === false ? false : undefined;
+    if (dir !== undefined) {
+        return (0, config_bundle_1.buildBundle)(dir, { ...(prune === undefined ? {} : { prune }) });
+    }
+    const explicit = options['data'] === undefined ? undefined : (0, input_1.readData)(options['data']);
+    const piped = explicit === undefined && (0, input_1.stdinIsPiped)() ?
+        (() => {
+            const raw = (0, input_1.readStdin)().trim();
+            return raw.length === 0 ? undefined : JSON.parse(raw);
+        })()
+        : undefined;
+    const body = explicit ?? piped;
+    if (body === undefined || typeof body !== 'object') {
+        throw new errors_1.UsageError('provide a config directory (e.g. `./roark`), or a bundle via --data / stdin');
+    }
+    const bundle = body;
+    return prune === undefined ? bundle : { ...bundle, prune };
+};
+const configGroup = (root) => {
+    const existing = root.commands.find((child) => child.name() === 'config');
+    if (existing)
+        return existing;
+    const created = new commander_1.Command('config').description('Config as code, and CLI settings').showHelpAfterError();
+    created.action(() => created.outputHelp());
+    root.addCommand(created);
+    return created;
+};
+const withCommonOptions = (command) => command
+    .option('--data <json>', 'pre-built bundle as JSON, or @file (@- for stdin); alternative to a directory')
+    .option('--no-prune', 'do not delete config-managed resources absent from the bundle')
+    .option('--base-url <url>', 'API base URL')
+    .option('--token <token>', 'bearer token')
+    .option('--timeout <ms>', 'request timeout in milliseconds')
+    .option('--max-retries <count>', 'retries for retryable failures')
+    .option('--format <format>', 'output format')
+    .option('--json', 'shorthand for --format json')
+    .option('--no-color', 'disable colour')
+    .showHelpAfterError();
+const registerConfigAsCodeCommands = (root, binaryName, clientFor, resolveOutput) => {
+    const config = configGroup(root);
+    withCommonOptions(config.command('diff [dir]'))
+        .description('Preview the changes a config directory (or bundle) would make. No writes.')
+        .addHelpText('after', ['', 'Examples:', `  ${binaryName} config diff ./roark`].join('\n'))
+        .action(async (dir, options) => {
+        const bundle = await resolveBundle(dir, options);
+        const client = clientFor(options);
+        const result = await client.config.diff(bundle);
+        const output = resolveOutput(options);
+        (0, output_1.write)(output.format === 'json' || options['json'] === true ?
+            (0, output_1.render)(result.data, output)
+            : formatChanges(result.data));
+    });
+    withCommonOptions(config.command('apply [dir]'))
+        .description('Reconcile the project to a config directory (or bundle). Previews and confirms first.')
+        .option('-y, --yes', 'skip the confirmation prompt')
+        .option('--no-input', 'never prompt; fail instead')
+        .addHelpText('after', ['', 'Examples:', `  ${binaryName} config apply ./roark`].join('\n'))
+        .action(async (dir, options) => {
+        const bundle = await resolveBundle(dir, options);
+        const client = clientFor(options);
+        const output = resolveOutput(options);
+        const json = output.format === 'json' || options['json'] === true;
+        // Preview then confirm, so a prune-driven delete is never a surprise.
+        const preview = (await client.config.diff(bundle));
+        const pending = changeCount(preview.data.summary);
+        if (pending === 0) {
+            (0, output_1.write)('No changes; project already matches the config.', process.stderr);
+            return;
+        }
+        if (!json)
+            (0, output_1.write)(formatChanges(preview.data), process.stderr);
+        await (0, confirm_1.confirm)(`Apply ${pending} change(s)?`, {
+            assumeYes: options['yes'] === true,
+            noInput: options['input'] === false,
+        });
+        const result = await client.config.apply(bundle);
+        (0, output_1.write)(json ?
+            (0, output_1.render)(result.data, output)
+            : formatChanges(result.data));
+    });
+    config.addHelpText('after', [
+        '',
+        'Config as code: keep your Roark resources as YAML in git and sync them.',
+        `  ${binaryName} config diff ./roark    # preview`,
+        `  ${binaryName} config apply ./roark   # reconcile (asks to confirm)`,
+    ].join('\n'));
+};
+exports.registerConfigAsCodeCommands = registerConfigAsCodeCommands;

package/runtime/config-bundle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Build a config-as-code bundle from a directory of YAML files.
+ *
+ * This is the one client-side step: read `*.yaml` / `*.yml` under a directory, parse each, inline
+ * any `file://` references, and collect them into the `{ resources, prune }` body the API's
+ * `config diff` / `config apply` endpoints take. The server validates and reconciles — so this
+ * loader stays deliberately schema-agnostic (no per-kind knowledge), and any drift is caught by
+ * the API, not silently accepted here.
+ */
+export interface ConfigBundle {
+    resources: Array<Record<string, unknown>>;
+    prune?: boolean;
+}
+/**
+ * Load every resource YAML under `dir` into a bundle. Files are read in sorted order for a
+ * deterministic result; each must be a single mapping with a `kind` and a `name`. Duplicate
+ * `kind/name` pairs are rejected up front (the server would reject them too, less clearly).
+ */
+export declare const buildBundle: (dir: string, options?: {
+    prune?: boolean;
+}) => Promise<ConfigBundle>;

package/runtime/config-bundle.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Build a config-as-code bundle from a directory of YAML files.
+ *
+ * This is the one client-side step: read `*.yaml` / `*.yml` under a directory, parse each, inline
+ * any `file://` references, and collect them into the `{ resources, prune }` body the API's
+ * `config diff` / `config apply` endpoints take. The server validates and reconciles — so this
+ * loader stays deliberately schema-agnostic (no per-kind knowledge), and any drift is caught by
+ * the API, not silently accepted here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildBundle = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const yaml_1 = require("yaml");
+const errors_1 = require("./errors");
+const FILE_PREFIX = 'file://';
+/**
+ * Resolve a single `file://relative/path` reference against the config root and return the file's
+ * contents. Absolute paths and any path that escapes the root are rejected — a config repo should
+ * only ever inline files it ships.
+ */
+const readFileRef = async (value, root) => {
+    const rel = value.slice(FILE_PREFIX.length);
+    const target = (0, node_path_1.isAbsolute)(rel) ? rel : (0, node_path_1.join)(root, rel);
+    if ((0, node_path_1.relative)(root, target).startsWith('..')) {
+        throw new errors_1.UsageError(`prompt path escapes the config directory: ${value}`);
+    }
+    return (0, promises_1.readFile)(target, 'utf8');
+};
+/**
+ * Deep-walk a parsed resource and replace every string that begins with `file://` with the
+ * referenced file's contents. Kind-agnostic: it inlines a `file://` wherever it appears (prompts,
+ * backstories, step content, …) so the loader needs no schema.
+ */
+const inlineFileRefs = async (value, root) => {
+    if (typeof value === 'string') {
+        return value.startsWith(FILE_PREFIX) ? readFileRef(value, root) : value;
+    }
+    if (Array.isArray(value)) {
+        return Promise.all(value.map((item) => inlineFileRefs(item, root)));
+    }
+    if (value && typeof value === 'object') {
+        const entries = await Promise.all(Object.entries(value).map(async ([key, val]) => [key, await inlineFileRefs(val, root)]));
+        return Object.fromEntries(entries);
+    }
+    return value;
+};
+/**
+ * Load every resource YAML under `dir` into a bundle. Files are read in sorted order for a
+ * deterministic result; each must be a single mapping with a `kind` and a `name`. Duplicate
+ * `kind/name` pairs are rejected up front (the server would reject them too, less clearly).
+ */
+const buildBundle = async (dir, options = {}) => {
+    const root = (0, node_path_1.resolve)(dir);
+    let entries;
+    try {
+        entries = (await (0, promises_1.readdir)(root, { recursive: true })).filter((rel) => rel.endsWith('.yaml') || rel.endsWith('.yml'));
+    }
+    catch {
+        throw new errors_1.UsageError(`config directory not found: ${dir}`);
+    }
+    entries.sort();
+    const resources = [];
+    const seen = new Map();
+    for (const rel of entries) {
+        if (rel.endsWith('roark.lock.json'))
+            continue;
+        let raw;
+        try {
+            raw = (0, yaml_1.parse)(await (0, promises_1.readFile)((0, node_path_1.join)(root, rel), 'utf8'));
+        }
+        catch (error) {
+            throw new errors_1.UsageError(`${rel}: invalid YAML: ${error.message}`);
+        }
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+            continue;
+        const resource = (await inlineFileRefs(raw, root));
+        const kind = resource['kind'];
+        const name = resource['name'];
+        if (typeof kind !== 'string' || typeof name !== 'string') {
+            throw new errors_1.UsageError(`${rel}: every resource needs a string 'kind' and 'name'`);
+        }
+        const key = `${kind}/${name}`;
+        const prior = seen.get(key);
+        if (prior)
+            throw new errors_1.UsageError(`${rel}: duplicate ${key} (also defined in ${prior})`);
+        seen.set(key, rel);
+        resources.push(resource);
+    }
+    if (resources.length === 0)
+        throw new errors_1.UsageError(`no config resources (*.yaml) found under ${dir}`);
+    return { resources, ...(options.prune === undefined ? {} : { prune: options.prune }) };
+};
+exports.buildBundle = buildBundle;

package/runtime/program.js

@@ -14,6 +14,7 @@ const commander_1 = require("commander");
 const sdk_1 = __importDefault(require("@roarkanalytics/sdk"));
 const api_1 = require("./commands/api");
 const auth_1 = require("./commands/auth");
+const config_as_code_1 = require("./commands/config-as-code");
 const config_1 = require("./commands/config");
 const completion_1 = require("./commands/completion");
 const confirm_1 = require("./confirm");
@@ -249,9 +250,16 @@ const createProgram = (options) => {
         .showHelpAfterError()
         .enablePositionalOptions();
     addGlobalOptions(root, { body: false, confirmation: false });
-    for (const definition of options.commands)
+    // `config diff` / `config apply` are hand-written (registerConfigAsCodeCommands) so they can take
+    // a config directory and confirm before writing; skip the raw generated versions of those two.
+    const isConfigAsCode = (path) => path.length === 2 && path[0] === 'config' && (path[1] === 'diff' || path[1] === 'apply');
+    for (const definition of options.commands) {
+        if (isConfigAsCode(definition.commandPath))
+            continue;
         addApiCommand(root, options, definition);
+    }
     (0, auth_1.registerAuthCommands)(root, options.binaryName);
+    (0, config_as_code_1.registerConfigAsCodeCommands)(root, options.binaryName, clientFor, exports.resolveOutput);
     (0, config_1.registerConfigCommands)(root, options.binaryName);
     (0, api_1.registerApiCommand)(root, options.binaryName, clientFor, exports.resolveOutput);
     (0, completion_1.registerCompletionCommand)(root, options.binaryName, options.completions);

package/version.d.ts

@@ -1 +1 @@
-export declare const version = "2.31.0";
+export declare const version = "0.2.0";

package/version.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
-// Bumped by hand, together with `version` in package.json. This package is not
-// in release-please-config.json's `extra-files`: the CLI ships from
-// publish-cli.yml rather than the vendor's release train, so no tooling rewrites
-// this line.
-exports.version = '2.31.0';
+// Generated by scripts/sync-version.cjs from this package's package.json, which
+// the build runs before tsc. Do not edit: an edit here is overwritten, and the
+// published number is whatever package.json says.
+//
+// It exists at all because the CLI is not in release-please-config.json's
+// `extra-files` - it ships from publish-cli.yml rather than the vendor's
+// release train - so nothing else keeps this in step.
+exports.version = '0.2.0';