@forumulate/cli 0.5.0 → 0.8.0

package/dist/api/spec.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The operation index `forumulate api` runs from.
+ *
+ * `operations.json` is cut from `packages/sdk/openapi.json` by
+ * `scripts/slim-spec.mjs`: every operation's method, path, params and request
+ * body shape, nothing else (the full spec is 21 MB; this is under 1). It is read
+ * lazily, so `forumulate whoami` does not pay to parse a thousand operations.
+ */
+/** A slimmed JSON Schema node (see `slim-spec.mjs` for the key names). */
+export interface SchemaNode {
+    $ref?: string;
+    /** type */
+    t?: string;
+    /** properties */
+    p?: Record<string, SchemaNode>;
+    /** required */
+    r?: string[];
+    /** items */
+    i?: SchemaNode;
+    /** enum */
+    e?: unknown[];
+    /** const */
+    c?: unknown;
+    /** description (first sentence) */
+    d?: string;
+    /** anyOf/oneOf, minus a null variant */
+    any?: SchemaNode[];
+    all?: SchemaNode[];
+    /** nullable */
+    n?: 1;
+}
+export interface Param {
+    n: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    r?: 1;
+    t?: string;
+    e?: unknown[];
+    d?: string;
+}
+export interface Operation {
+    id: string;
+    m: string;
+    p: string;
+    s?: string;
+    t?: string[];
+    q?: Param[];
+    /** Declares `Idempotency-Key`: the CLI sends one, so a retried write is not a second write. */
+    ik?: 1;
+    b?: SchemaNode;
+    /** multipart/form-data body */
+    mp?: 1;
+    /** body required */
+    br?: 1;
+    dep?: 1;
+}
+export interface OperationIndex {
+    info: {
+        title?: string;
+        version?: string;
+    };
+    ops: Operation[];
+    schemas: Record<string, SchemaNode>;
+}
+export declare function loadIndex(): OperationIndex;
+/** For tests: run against an index that is not the bundled one. */
+export declare function setIndex(index: OperationIndex | undefined): void;
+export declare function resolveRef(node: SchemaNode | undefined, index?: OperationIndex): SchemaNode | undefined;
+/**
+ * The top-level properties a body accepts, across every variant of a `oneOf`
+ * (blog/forum/changelog take a block-JSON form OR a markdown form) — the set a
+ * `--field` flag may name.
+ */
+export declare function bodyProperties(op: Operation, index?: OperationIndex): Record<string, SchemaNode>;
+export declare function pathParams(op: Operation): string[];
+export declare const isMethod: (s: string | undefined) => boolean;
+/** By operationId — exact first, then case-insensitive, so `space_list` works too. */
+export declare function findById(id: string, index?: OperationIndex): Operation | undefined;
+/**
+ * By method and path: a template (`/orgs/{orgId}/spaces`) or a concrete path
+ * (`/orgs/acme/spaces`). A concrete path also hands back the values it filled
+ * in, so `forumulate api GET /orgs/acme/spaces --paginate` knows `orgId=acme`.
+ *
+ * A literal segment beats a parameter, the same rule the API's router applies:
+ * `/orgs/acme/members/invites` is the invite list, not member `invites`.
+ */
+export declare function findByPath(method: string, rawPath: string, index?: OperationIndex): {
+    op: Operation;
+    values: Record<string, string>;
+} | undefined;
+export interface ListFilter {
+    tag?: string;
+    search?: string;
+    method?: string;
+}
+export declare function filterOps(filter: ListFilter, index?: OperationIndex): Operation[];
+//# sourceMappingURL=spec.d.ts.map

package/dist/api/spec.d.ts.map

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

package/dist/api/spec.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMethod = void 0;
+exports.loadIndex = loadIndex;
+exports.setIndex = setIndex;
+exports.resolveRef = resolveRef;
+exports.bodyProperties = bodyProperties;
+exports.pathParams = pathParams;
+exports.findById = findById;
+exports.findByPath = findByPath;
+exports.filterOps = filterOps;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+let cached;
+function loadIndex() {
+    if (!cached) {
+        cached = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, 'operations.json'), 'utf8'));
+    }
+    return cached;
+}
+/** For tests: run against an index that is not the bundled one. */
+function setIndex(index) {
+    cached = index;
+}
+function resolveRef(node, index = loadIndex()) {
+    let n = node;
+    for (let i = 0; n?.$ref && i < 20; i++)
+        n = index.schemas[n.$ref];
+    return n ?? undefined;
+}
+/**
+ * The top-level properties a body accepts, across every variant of a `oneOf`
+ * (blog/forum/changelog take a block-JSON form OR a markdown form) — the set a
+ * `--field` flag may name.
+ */
+function bodyProperties(op, index = loadIndex()) {
+    const out = {};
+    const visit = (raw, depth) => {
+        const node = resolveRef(raw, index);
+        if (!node || depth > 4)
+            return;
+        for (const [k, v] of Object.entries(node.p ?? {}))
+            out[k] ??= resolveRef(v, index) ?? {};
+        for (const v of node.any ?? [])
+            visit(v, depth + 1);
+        for (const v of node.all ?? [])
+            visit(v, depth + 1);
+    };
+    visit(op.b, 0);
+    return out;
+}
+function pathParams(op) {
+    return [...op.p.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
+}
+const METHODS = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
+const isMethod = (s) => Boolean(s && METHODS.has(s.toUpperCase()));
+exports.isMethod = isMethod;
+/** By operationId — exact first, then case-insensitive, so `space_list` works too. */
+function findById(id, index = loadIndex()) {
+    return (index.ops.find((o) => o.id === id) ??
+        index.ops.find((o) => o.id.toLowerCase() === id.toLowerCase()));
+}
+/**
+ * By method and path: a template (`/orgs/{orgId}/spaces`) or a concrete path
+ * (`/orgs/acme/spaces`). A concrete path also hands back the values it filled
+ * in, so `forumulate api GET /orgs/acme/spaces --paginate` knows `orgId=acme`.
+ *
+ * A literal segment beats a parameter, the same rule the API's router applies:
+ * `/orgs/acme/members/invites` is the invite list, not member `invites`.
+ */
+function findByPath(method, rawPath, index = loadIndex()) {
+    const m = method.toUpperCase();
+    const path = rawPath
+        .split('?')[0]
+        .replace(/^\/api(?=\/)/, '')
+        .replace(/\/+$/, '') || '/';
+    const want = path.split('/');
+    let best;
+    for (const op of index.ops) {
+        if (op.m !== m)
+            continue;
+        if (op.p === path)
+            return { op, values: {} };
+        const have = op.p.split('/');
+        if (have.length !== want.length)
+            continue;
+        const values = {};
+        let score = 0;
+        let ok = true;
+        for (let i = 0; i < have.length; i++) {
+            const seg = have[i];
+            const param = seg.match(/^\{([^}]+)\}$/);
+            if (param) {
+                // `{orgId}` typed literally is the template, not a value.
+                if (want[i] !== seg)
+                    values[param[1]] = decodeURIComponent(want[i]);
+            }
+            else if (seg === want[i])
+                score++;
+            else {
+                ok = false;
+                break;
+            }
+        }
+        if (ok && (!best || score > best.score))
+            best = { op, values, score };
+    }
+    return best && { op: best.op, values: best.values };
+}
+function filterOps(filter, index = loadIndex()) {
+    const tag = filter.tag?.toLowerCase();
+    const words = (filter.search ?? '').toLowerCase().split(/\s+/).filter(Boolean);
+    return index.ops.filter((o) => {
+        if (filter.method && o.m !== filter.method.toUpperCase())
+            return false;
+        if (tag && !(o.t ?? []).some((t) => t.toLowerCase() === tag))
+            return false;
+        if (words.length) {
+            const hay = `${o.id} ${o.m} ${o.p} ${o.s ?? ''} ${(o.t ?? []).join(' ')}`.toLowerCase();
+            if (!words.every((w) => hay.includes(w)))
+                return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=spec.js.map

package/dist/api/spec.js.map

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

package/dist/commands/completion.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shell completion: `forumulate completion bash|zsh|fish` prints a script, and
+ * the script asks the CLI itself (`forumulate __complete <words…>`) what comes
+ * next. One source of candidates for three shells, so a verb added to
+ * `groups.ts` or an operation added to the spec completes everywhere with no
+ * script to regenerate.
+ */
+export declare const TOP_LEVEL: string[];
+/** Candidates for the word being completed, given the words before it. */
+export declare function complete(words: string[]): string[];
+export declare function completionScript(shell: string): string | undefined;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,UAcrB,CAAC;AAIF,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAmDlD;AAyCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BlE"}

package/dist/commands/completion.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOP_LEVEL = void 0;
+exports.complete = complete;
+exports.completionScript = completionScript;
+const spec_1 = require("../api/spec");
+const groups_1 = require("./groups");
+const config_1 = require("./config");
+/**
+ * Shell completion: `forumulate completion bash|zsh|fish` prints a script, and
+ * the script asks the CLI itself (`forumulate __complete <words…>`) what comes
+ * next. One source of candidates for three shells, so a verb added to
+ * `groups.ts` or an operation added to the spec completes everywhere with no
+ * script to regenerate.
+ */
+exports.TOP_LEVEL = [
+    'login',
+    'logout',
+    'whoami',
+    'config',
+    'api',
+    'publish',
+    'snapshot',
+    'content',
+    'import',
+    'conformance',
+    'doctor',
+    'completion',
+    'help',
+];
+const COMMON_FLAGS = ['--json', '--org', '--space', '--paginate', '--dry-run', '--help', '--yes'];
+/** Candidates for the word being completed, given the words before it. */
+function complete(words) {
+    const [cmd, ...rest] = words;
+    const current = rest.length ? rest[rest.length - 1] : (cmd ?? '');
+    const before = rest.slice(0, -1);
+    if (rest.length === 0) {
+        const all = [...exports.TOP_LEVEL, ...groups_1.GROUPS.flatMap((g) => [g.name, ...(g.aliases ?? [])])];
+        return all.filter((w) => w.startsWith(current)).sort();
+    }
+    if (current.startsWith('-'))
+        return flagsFor(cmd, before).filter((f) => f.startsWith(current));
+    const positionals = before.filter((w) => !w.startsWith('-'));
+    if (cmd === 'api') {
+        if (positionals.length === 0) {
+            if (current === '' || /^[A-Z]/.test(current)) {
+                const ids = (0, spec_1.loadIndex)().ops.map((o) => o.id);
+                return ['list', 'describe', 'GET', 'POST', 'PUT', 'PATCH', 'DELETE', ...ids].filter((w) => w.startsWith(current));
+            }
+            return ['list', 'describe', ...(0, spec_1.loadIndex)().ops.map((o) => o.id)].filter((w) => w.startsWith(current));
+        }
+        if (positionals[0] === 'describe' && positionals.length === 1)
+            return (0, spec_1.loadIndex)()
+                .ops.map((o) => o.id)
+                .filter((w) => w.startsWith(current));
+        if ((0, spec_1.isMethod)(positionals[0]) && positionals.length === 1)
+            return (0, spec_1.filterOps)({ method: positionals[0] })
+                .map((o) => o.p)
+                .filter((p) => p.startsWith(current));
+        return [];
+    }
+    if (cmd === 'config') {
+        if (positionals.length === 0)
+            return ['set', 'get', 'unset', 'list', 'path'].filter((w) => w.startsWith(current));
+        if (positionals.length === 1)
+            return Object.keys(config_1.CONFIG_KEYS).filter((w) => w.startsWith(current));
+        return [];
+    }
+    if (cmd === 'completion')
+        return ['bash', 'zsh', 'fish'].filter((w) => w.startsWith(current));
+    const g = (0, groups_1.findGroup)(cmd);
+    if (!g)
+        return [];
+    const verbs = Object.keys(g.verbs);
+    if (positionals.length === 0)
+        return [...new Set(verbs.map((v) => v.split(' ')[0]))].filter((w) => w.startsWith(current));
+    if (positionals.length === 1)
+        return verbs
+            .filter((v) => v.startsWith(`${positionals[0]} `))
+            .map((v) => v.split(' ')[1])
+            .filter((w) => w.startsWith(current));
+    return [];
+}
+function flagsFor(cmd, before) {
+    const positionals = before.filter((w) => !w.startsWith('-'));
+    if (cmd === 'api') {
+        const op = (positionals[0] && (0, spec_1.findById)(positionals[0])) ||
+            ((0, spec_1.isMethod)(positionals[0]) && positionals[1]
+                ? (0, spec_1.findByPath)(positionals[0], positionals[1])?.op
+                : undefined);
+        const own = [
+            '--data',
+            '--field',
+            '--param',
+            '--header',
+            '--paginate',
+            '--json',
+            '--columns',
+            '--dry-run',
+            '--api-version',
+            '--include-headers',
+        ];
+        return [...(op?.q ?? []).map((p) => `--${p.n}`), ...own];
+    }
+    const g = (0, groups_1.findGroup)(cmd);
+    if (!g)
+        return COMMON_FLAGS;
+    const verb = g.verbs[`${positionals[0]} ${positionals[1]}`] ?? g.verbs[positionals[0] ?? ''];
+    const op = verb && (0, spec_1.findById)(verb.op);
+    const params = (op?.q ?? []).filter((p) => p.in === 'query').map((p) => `--${p.n}`);
+    return [
+        ...new Set([
+            ...COMMON_FLAGS,
+            ...params,
+            ...(verb?.markdown ? ['--file'] : []),
+            ...(verb?.download ? ['--out'] : []),
+            '--data',
+            '--field',
+        ]),
+    ];
+}
+function completionScript(shell) {
+    switch (shell) {
+        case 'bash':
+            return `# forumulate bash completion — add to ~/.bashrc:
+#   eval "$(forumulate completion bash)"
+_forumulate() {
+  local IFS=$'\\n'
+  COMPREPLY=($(forumulate __complete "\${COMP_WORDS[@]:1:COMP_CWORD}" 2>/dev/null))
+}
+complete -o default -F _forumulate forumulate
+`;
+        case 'zsh':
+            return `#compdef forumulate
+# forumulate zsh completion — add to ~/.zshrc:
+#   eval "$(forumulate completion zsh)"
+_forumulate() {
+  local -a candidates
+  candidates=("\${(@f)$(forumulate __complete "\${(@)words[2,CURRENT]}" 2>/dev/null)}")
+  compadd -a candidates
+}
+compdef _forumulate forumulate
+`;
+        case 'fish':
+            return `# forumulate fish completion — save as ~/.config/fish/completions/forumulate.fish
+#   forumulate completion fish > ~/.config/fish/completions/forumulate.fish
+complete -c forumulate -f -a '(forumulate __complete (commandline -opc)[2..-1] (commandline -ct) 2>/dev/null)'
+`;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `forumulate config` — defaults a person would otherwise type on every call.
+ *
+ * Stored beside the credentials (same directory, `FORUMULATE_CONFIG_DIR`
+ * honoured) but in its own file: a config is something you paste into a bug
+ * report, and a token must never ride along with it.
+ *
+ * Precedence for every key is flag → environment → this file, so CI that
+ * passes `--org` or `FORUMULATE_ORG` is never overridden by a laptop's file.
+ */
+export declare const CONFIG_KEYS: Record<string, {
+    env: string;
+    about: string;
+}>;
+export type CliConfig = Partial<Record<string, string>>;
+export declare function configPath(env?: NodeJS.ProcessEnv): string;
+export declare function readConfig(env?: NodeJS.ProcessEnv): CliConfig;
+export declare function writeConfig(cfg: CliConfig, env?: NodeJS.ProcessEnv): string;
+/** flag → env → file. */
+export declare function setting(key: keyof typeof CONFIG_KEYS & string, flagValue: string | undefined, env: NodeJS.ProcessEnv, cfg: CliConfig): string | undefined;
+export declare const CONFIG_HELP: string;
+export declare function runConfig(positionals: string[], json: boolean, io: {
+    out: (l: string) => void;
+    err: (l: string) => void;
+    env: NodeJS.ProcessEnv;
+}): number;
+/**
+ * The environment the older commands read (`content`, `import`), with the
+ * config file's defaults filled in where the environment says nothing — so
+ * `config set org` reaches them too without teaching each one to read a file.
+ */
+export declare function envWithConfig(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQtE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAExD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEvE;AAED,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,CAO1E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAMxF;AAED,yBAAyB;AACzB,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,OAAO,WAAW,GAAG,MAAM,EACtC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,EAAE,SAAS,GACb,MAAM,GAAG,SAAS,CAGpB;AAED,eAAO,MAAM,WAAW,QAc2C,CAAC;AAEpE,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACjF,MAAM,CAwDR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAMrF"}

package/dist/commands/config.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_HELP = exports.CONFIG_KEYS = void 0;
+exports.configPath = configPath;
+exports.readConfig = readConfig;
+exports.writeConfig = writeConfig;
+exports.setting = setting;
+exports.runConfig = runConfig;
+exports.envWithConfig = envWithConfig;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const credentials_1 = require("../credentials");
+/**
+ * `forumulate config` — defaults a person would otherwise type on every call.
+ *
+ * Stored beside the credentials (same directory, `FORUMULATE_CONFIG_DIR`
+ * honoured) but in its own file: a config is something you paste into a bug
+ * report, and a token must never ride along with it.
+ *
+ * Precedence for every key is flag → environment → this file, so CI that
+ * passes `--org` or `FORUMULATE_ORG` is never overridden by a laptop's file.
+ */
+exports.CONFIG_KEYS = {
+    org: { env: 'FORUMULATE_ORG', about: 'default organization (id or slug) for --org' },
+    space: { env: 'FORUMULATE_SPACE', about: 'default space (id or slug) for --space' },
+    library: { env: 'FORUMULATE_LIBRARY', about: 'default content library for --library' },
+    'api-version': {
+        env: 'FORUMULATE_API_VERSION',
+        about: 'Forumulate-Version header sent by `api` and the resource commands',
+    },
+};
+function configPath(env = process.env) {
+    return (0, node_path_1.join)((0, node_path_1.dirname)((0, credentials_1.credentialsPath)(env)), 'config.json');
+}
+function readConfig(env = process.env) {
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(configPath(env), 'utf8'));
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfig(cfg, env = process.env) {
+    const path = configPath(env);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true, mode: 0o700 });
+    (0, node_fs_1.writeFileSync)(path, `${JSON.stringify(cfg, null, 2)}\n`, { mode: 0o600 });
+    (0, node_fs_1.chmodSync)(path, 0o600);
+    return path;
+}
+/** flag → env → file. */
+function setting(key, flagValue, env, cfg) {
+    const fromEnv = env[exports.CONFIG_KEYS[key].env]?.trim();
+    return flagValue ?? (fromEnv || undefined) ?? cfg[key];
+}
+exports.CONFIG_HELP = `forumulate config — defaults for every command
+
+Usage:
+  forumulate config set <key> <value>
+  forumulate config get <key>
+  forumulate config unset <key>
+  forumulate config list [--json]
+  forumulate config path
+
+Keys:
+${Object.entries(exports.CONFIG_KEYS)
+    .map(([k, v]) => `  ${k.padEnd(12)} ${v.about} (env ${v.env})`)
+    .join('\n')}
+
+A flag beats the environment, and the environment beats this file.`;
+function runConfig(positionals, json, io) {
+    const [verb, key, ...value] = positionals;
+    const cfg = readConfig(io.env);
+    const known = (k) => {
+        if (k && k in exports.CONFIG_KEYS)
+            return true;
+        io.err(`Unknown key "${k ?? ''}". Keys: ${Object.keys(exports.CONFIG_KEYS).join(', ')}`);
+        return false;
+    };
+    switch (verb) {
+        case 'set': {
+            if (!known(key))
+                return 1;
+            if (value.length === 0) {
+                io.err(`Usage: forumulate config set ${key} <value>`);
+                return 1;
+            }
+            cfg[key] = value.join(' ');
+            const path = writeConfig(cfg, io.env);
+            io.out(`${key} = ${cfg[key]}  (${path})`);
+            return 0;
+        }
+        case 'get': {
+            if (!known(key))
+                return 1;
+            const v = setting(key, undefined, io.env, cfg);
+            if (v === undefined)
+                return 1;
+            io.out(v);
+            return 0;
+        }
+        case 'unset': {
+            if (!known(key))
+                return 1;
+            delete cfg[key];
+            writeConfig(cfg, io.env);
+            io.out(`${key} unset`);
+            return 0;
+        }
+        case 'list':
+        case undefined: {
+            const rows = Object.keys(exports.CONFIG_KEYS).map((k) => {
+                const env = io.env[exports.CONFIG_KEYS[k].env]?.trim();
+                return { key: k, value: env || cfg[k] || '', from: env ? 'env' : cfg[k] ? 'file' : '' };
+            });
+            if (json)
+                io.out(JSON.stringify(Object.fromEntries(rows.map((r) => [r.key, r.value || null])), null, 2));
+            else
+                for (const r of rows)
+                    io.out(`${r.key.padEnd(12)} ${r.value || '-'}${r.from ? `  (${r.from})` : ''}`);
+            return 0;
+        }
+        case 'path':
+            io.out(configPath(io.env));
+            return 0;
+        default:
+            io.out(exports.CONFIG_HELP);
+            return verb === 'help' ? 0 : 1;
+    }
+}
+/**
+ * The environment the older commands read (`content`, `import`), with the
+ * config file's defaults filled in where the environment says nothing — so
+ * `config set org` reaches them too without teaching each one to read a file.
+ */
+function envWithConfig(env = process.env) {
+    const cfg = readConfig(env);
+    const out = { ...env };
+    for (const [key, { env: name }] of Object.entries(exports.CONFIG_KEYS))
+        if (!out[name]?.trim() && cfg[key])
+            out[name] = cfg[key];
+    return out;
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,35 @@
+import type { Http } from '../api/http';
+import type { CliConfig } from './config';
+/**
+ * What `forumulate api` and the resource commands need from the outside world,
+ * all injected so the tests drive them against a fake server and no disk.
+ */
+export interface CommandDeps {
+    http: Http;
+    out: (line: string) => void;
+    err: (line: string) => void;
+    env: NodeJS.ProcessEnv;
+    config: CliConfig;
+    readFile: (path: string) => string | Buffer;
+    /** Where `--out <file>` lands: a downloaded archive, PDF or export. */
+    writeFile: (path: string, data: Buffer | string) => void;
+    readStdin: () => Promise<string>;
+    /** A visible y/N question; absent when nobody can answer (CI, a pipe). */
+    ask?: (question: string) => Promise<string>;
+    /** `--org` → `FORUMULATE_ORG` → `config set org`, already resolved. */
+    defaultOrg?: string;
+}
+export declare const isUuid: (s: string) => boolean;
+/**
+ * A space by id or slug. `/orgs/{orgId}` takes a slug; `/spaces/{spaceId}`
+ * takes only the id, and "pass the uuid" is not an answer a person typing
+ * `--space docs` should get. One list call, only when it is not already an id.
+ */
+export declare function resolveChild(deps: CommandDeps, what: 'space' | 'library', orgId: string, ref: string): Promise<string>;
+/**
+ * The y/N before anything irreversible. `--yes` skips it; with no terminal to
+ * ask on, `--yes` is required — a delete in CI that silently proceeds because
+ * nobody could be asked is the outcome the question exists to prevent.
+ */
+export declare function confirm(deps: CommandDeps, yes: boolean, question: string): Promise<boolean>;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IAC5C,uEAAuE;IACvE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACzD,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,OACwC,CAAC;AAE5E;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjG"}