primitive-admin 1.1.0-alpha.9 → 1.1.0

package/dist/src/commands/env.js

@@ -0,0 +1,395 @@
+/**
+ * `primitive env` commands — manage named environments in primitive/config.json.
+ *
+ * Subcommands:
+ *   env list              — show all environments
+ *   env add <name>        — add a new environment
+ *   env remove <name>     — delete an environment
+ *   env use <name>        — select the environment THIS machine uses
+ *   env show [name]       — show details for an environment (default: current)
+ *
+ * Two different things live here, and #2873 stopped them sharing one field:
+ *   - `defaultEnvironment` in the committed config is the TEAM default — what
+ *     a fresh clone resolves.
+ *   - `.primitive/local.json` is THIS machine's selection, written by
+ *     `env use`. It is gitignored, so switching backends never dirties a
+ *     tracked file.
+ *
+ * `list` and `show` therefore refuse to paper over a broken selection: corrupt
+ * local state, or a selection naming an environment that no longer exists, is
+ * a different situation from "nothing is selected" and has a different remedy.
+ */
+import { PROJECT_CONFIG_DISPLAY_NAME, ProjectConfigError, findProjectConfigPath, loadProjectConfig, saveProjectConfig, } from "../lib/project-config.js";
+import { getCurrentEnvironment, resetEnvResolver, } from "../lib/env-resolver.js";
+import { PrimitiveEnvError, localStatePathForConfigPath, missingConfigMessage, projectRootForConfigPath, readLocalSelection, } from "../lib/env-resolver-core.js";
+import { clearLocalSelection, ensureLocalStateIgnored, writeLocalSelection, } from "../lib/local-state.js";
+import { clearCredentialsForEnvInProject } from "../lib/credentials-store.js";
+import { normalizeIosAppId, validateIosAppId } from "../lib/ios-app-id.js";
+import { validateServerUrl } from "../lib/server-url.js";
+import { normalizeWebUrl, validateWebUrl } from "../lib/web-url.js";
+import { error, info, keyValue, result as printResult, success, warn, json, formatTable, divider, } from "../lib/output.js";
+import { wholeListEnvelope } from "../lib/paginate.js";
+/** How the per-machine selection file is named in user-facing messages. */
+const LOCAL_STATE_LABEL = ".primitive/local.json";
+function requireProjectConfig() {
+    const path = findProjectConfigPath();
+    if (!path) {
+        error(missingConfigMessage(process.cwd()));
+        process.exit(1);
+    }
+    try {
+        const config = loadProjectConfig();
+        return { path, config };
+    }
+    catch (err) {
+        if (err instanceof ProjectConfigError) {
+            error(err.message);
+        }
+        else {
+            error(err.message || String(err));
+        }
+        process.exit(1);
+    }
+}
+function writeProjectConfig(path, config) {
+    saveProjectConfig(path, config);
+    resetEnvResolver();
+}
+function validateEnvName(name) {
+    if (!name.match(/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/)) {
+        return `Invalid environment name "${name}". Use alphanumeric characters, dashes, or underscores.`;
+    }
+    return null;
+}
+/**
+ * The environment display commands resolve for real rather than through the
+ * error-swallowing `getCurrentEnvNameSafe()`. A selection that cannot resolve
+ * is the whole point of these commands: hiding it behind "(none)" is how a
+ * user ends up staring at a table that disagrees with every other command.
+ */
+function resolveForDisplay() {
+    try {
+        const configPath = findProjectConfigPath();
+        const selected = configPath ? readLocalSelection(configPath) : null;
+        return { name: getCurrentEnvironment()?.name ?? null, selected };
+    }
+    catch (err) {
+        if (err instanceof PrimitiveEnvError && err.kind === "no-selection") {
+            // Nothing selected among several environments is a legitimate state to
+            // display — the table shows them all and marks no current one.
+            return { name: null, selected: null };
+        }
+        error(err.message || String(err));
+        process.exit(1);
+    }
+}
+export function registerEnvCommands(program) {
+    const env = program
+        .command("env")
+        .description("Manage named environments in primitive/config.json")
+        .addHelpText("after", `
+Examples:
+  $ primitive env list                                 # list environments
+  $ primitive env add prod --api-url https://... --app-id 01HXY...
+  $ primitive env use prod                             # select it on this machine
+  $ primitive env show dev                             # show env details
+  $ primitive env remove staging                       # remove an environment
+
+Every environment names exactly one app, so --app-id is required. To point an
+existing environment at a different app, edit its "appId" in
+primitive/config.json.
+`);
+    // env list
+    env
+        .command("list")
+        .description("List all environments")
+        .option("--json", "Output as JSON")
+        .action((options) => {
+        const { config } = requireProjectConfig();
+        const { name: current, selected } = resolveForDisplay();
+        const rows = Object.entries(config.environments).map(([name, e]) => ({
+            name,
+            apiUrl: e.apiUrl,
+            appId: e.appId,
+            current: name === current ? "*" : "",
+            default: name === config.defaultEnvironment ? "*" : "",
+        }));
+        if (options.json) {
+            // The one list envelope (#3646). The environments are the rows — each
+            // carrying the name it was keyed by — and the selection context sits
+            // beside them, so a script reads `.items` here exactly as it does for
+            // every other `list`.
+            json({
+                ...wholeListEnvelope(Object.entries(config.environments).map(([name, environment]) => ({
+                    name,
+                    ...environment,
+                    current: name === current,
+                    default: name === config.defaultEnvironment,
+                }))),
+                currentEnvironment: current,
+                selectedEnvironment: selected,
+                defaultEnvironment: config.defaultEnvironment || null,
+            });
+            return;
+        }
+        if (rows.length === 0) {
+            info(`No environments defined. Run 'primitive env add <name>' to add one.`);
+            return;
+        }
+        console.log(formatTable(rows, [
+            { key: "current", header: "CURRENT" },
+            { key: "name", header: "Name" },
+            { key: "apiUrl", header: "API URL" },
+            { key: "appId", header: "App ID" },
+            { key: "default", header: "TEAM DEFAULT" },
+        ]));
+        if (selected) {
+            info(`"${selected}" is selected on this machine (${LOCAL_STATE_LABEL}).`);
+        }
+        else if (config.defaultEnvironment) {
+            info(`No local selection; falling back to the committed default "${config.defaultEnvironment}". Run 'primitive env use <name>' to choose one.`);
+        }
+    });
+    // env add
+    env
+        .command("add")
+        .description("Add a new environment")
+        .argument("<name>", "Environment name (e.g. dev, prod, staging)")
+        .requiredOption("--api-url <url>", "API base URL for this environment")
+        .requiredOption("--app-id <id>", "App ID bound to this environment")
+        .option("--app-name <name>", "Optional app name (display only)")
+        .option("--web-url <url>", "Optional web origin for this environment (https://app.example.com) — the app's web deployment, which the emailed sign-in link points at")
+        .option("--ios-app-id <id>", "Optional Apple app identifier for this environment's iOS client (ABCDE12345.com.example.app) — the deploy generates the apple-app-site-association document from it; requires --web-url")
+        .option("--description <text>", "Optional description")
+        .option("--default", "Set this environment as the new default")
+        .action((name, options) => {
+        const validationError = validateEnvName(name);
+        if (validationError) {
+            error(validationError);
+            process.exit(1);
+        }
+        // Validate URLs before touching disk.
+        if (validateServerUrl(options.apiUrl) !== true) {
+            error(`Invalid --api-url: ${options.apiUrl}`);
+            process.exit(1);
+        }
+        // `requiredOption` only rejects an ABSENT --app-id: an explicitly
+        // supplied empty or whitespace-only value parses fine and would be
+        // written straight through, creating a config the CLI's own startup
+        // validation then rejects (#3152). Checked here, before any file is
+        // touched, so a refused `env add` leaves nothing behind.
+        const appId = String(options.appId).trim();
+        if (!appId) {
+            error(`--app-id must name an app. Every environment names exactly one app; pass '--app-id <app-id>' with a real id.`);
+            process.exit(1);
+        }
+        if (options.webUrl !== undefined) {
+            const problem = validateWebUrl(options.webUrl);
+            if (problem !== true) {
+                error(`Invalid --web-url: ${problem}`);
+                process.exit(1);
+            }
+        }
+        // Both or neither (#3081): the association document that vouches for the
+        // iOS app is served by the web app, so an app id with no origin names an
+        // app no deploy of this environment could ever claim.
+        if (options.iosAppId !== undefined) {
+            if (options.webUrl === undefined) {
+                error(`--ios-app-id needs --web-url: the apple-app-site-association document naming that app is served by this environment's web app, so the deploy has to know its origin.`);
+                process.exit(1);
+            }
+            const problem = validateIosAppId(options.iosAppId);
+            if (problem !== true) {
+                error(`Invalid --ios-app-id: ${problem}`);
+                process.exit(1);
+            }
+        }
+        const { path, config } = requireExistingConfig();
+        if (config.environments[name]) {
+            error(`Environment "${name}" already exists. Use 'primitive env remove ${name}' first or edit ${PROJECT_CONFIG_DISPLAY_NAME} directly.`);
+            process.exit(1);
+        }
+        config.environments[name] = {
+            apiUrl: options.apiUrl.replace(/\/$/, ""),
+            appId,
+            appName: options.appName,
+            webUrl: options.webUrl === undefined ? undefined : normalizeWebUrl(options.webUrl),
+            iosAppId: options.iosAppId === undefined
+                ? undefined
+                : normalizeIosAppId(options.iosAppId),
+            description: options.description,
+        };
+        // Auto-default if this is the first env, or if --default was passed.
+        if (options.default || !config.defaultEnvironment) {
+            config.defaultEnvironment = name;
+        }
+        writeProjectConfig(path, config);
+        success(`Added environment "${name}".`);
+        keyValue("API URL", config.environments[name].apiUrl);
+        keyValue("App ID", appId);
+        if (config.environments[name].webUrl) {
+            keyValue("Web URL", config.environments[name].webUrl);
+        }
+        if (config.environments[name].iosAppId) {
+            keyValue("iOS App ID", config.environments[name].iosAppId);
+        }
+        if (config.defaultEnvironment === name) {
+            info(`"${name}" is now the default environment.`);
+        }
+        else {
+            info(`Run 'primitive env use ${name}' to point this machine at it.`);
+        }
+    });
+    // env remove
+    env
+        .command("remove")
+        .alias("rm")
+        .description("Remove an environment")
+        .argument("<name>", "Environment name")
+        .action((name) => {
+        const { path, config } = requireProjectConfig();
+        if (!config.environments[name]) {
+            error(`Environment "${name}" does not exist.`);
+            process.exit(1);
+        }
+        delete config.environments[name];
+        if (config.defaultEnvironment === name) {
+            delete config.defaultEnvironment;
+            warn(`"${name}" was the default environment. Set a new default with 'primitive env use <name>'.`);
+        }
+        writeProjectConfig(path, config);
+        // A selection naming an environment that no longer exists would make
+        // every later command fail on an unknown-environment error, so drop it
+        // with the environment it names.
+        if (clearLocalSelection(path, name)) {
+            info(`Cleared the local selection of "${name}" (${LOCAL_STATE_LABEL}).`);
+        }
+        // Also drop the credentials slot for this env so a subsequent `env add`
+        // with the same name can't silently re-use stale tokens from the old
+        // instance. The root comes from the one function that derives it: the
+        // parent of `primitive/`, or the containing directory for a bare
+        // PRIMITIVE_PROJECT_CONFIG — where a grandparent would name someone
+        // else's project and leave this one's credentials behind (#3153).
+        clearCredentialsForEnvInProject(projectRootForConfigPath(path), name);
+        success(`Removed environment "${name}".`);
+    });
+    // env use
+    env
+        .command("use")
+        .description("Select the environment this machine uses (local, not committed)")
+        .argument("<name>", "Environment name")
+        .action((name) => {
+        const { path, config } = requireProjectConfig();
+        if (!config.environments[name]) {
+            error(`Environment "${name}" does not exist. Run 'primitive env list' to see available environments.`);
+            process.exit(1);
+        }
+        // Ignore coverage BEFORE the write: a selection that shows up in
+        // `git status` is the tracked-file problem this replaced, just moved to
+        // an untracked file.
+        const localPath = localStatePathForConfigPath(path);
+        const coverage = ensureLocalStateIgnored(localPath);
+        if (coverage.status === "excluded") {
+            info(`Added "${coverage.pattern}" to ${coverage.excludePath} so the selection stays out of git.`);
+            info(`Consider committing "${LOCAL_STATE_LABEL}" to .gitignore so the whole team is covered.`);
+        }
+        else if (coverage.status === "failed") {
+            // Stop rather than write: an unignored local.json is committable state,
+            // which is the whole problem `env use` moved off the tracked config.
+            // The remedy is one line in .gitignore, after which this succeeds.
+            error(`Could not confirm ${LOCAL_STATE_LABEL} is git-ignored: ${coverage.detail}`);
+            error(`Add "${LOCAL_STATE_LABEL}" to your .gitignore and run 'primitive env use ${name}' again — ` +
+                `the selection is per-machine state and must never be committable.`);
+            process.exit(1);
+        }
+        writeLocalSelection(path, name);
+        resetEnvResolver();
+        success(`Now using environment "${name}" on this machine.`);
+        keyValue("API URL", config.environments[name].apiUrl);
+        if (config.environments[name].appId) {
+            keyValue("App ID", config.environments[name].appId);
+        }
+        if (config.environments[name].webUrl) {
+            keyValue("Web URL", config.environments[name].webUrl);
+        }
+        if (config.environments[name].iosAppId) {
+            keyValue("iOS App ID", config.environments[name].iosAppId);
+        }
+        info(`Selection stored in ${localPath} (local state — never committed).`);
+        info(config.defaultEnvironment
+            ? `The committed team default ("defaultEnvironment") is still "${config.defaultEnvironment}".`
+            : `No committed team default ("defaultEnvironment") is set for a fresh clone.`);
+    });
+    // env show
+    env
+        .command("show")
+        .description("Show details for an environment")
+        .argument("[name]", "Environment name (defaults to current)")
+        .option("--json", "Output as JSON")
+        .action((name, options) => {
+        const { config } = requireProjectConfig();
+        // "Current" means the resolved env (honoring --env / PRIMITIVE_ENV / the
+        // local selection / defaultEnvironment). We intentionally read this
+        // AFTER requireProjectConfig() so errors surface in a consistent order —
+        // and we do NOT swallow a broken selection, which would show the default
+        // as though it were current.
+        const resolvedName = name ? null : resolveForDisplay().name;
+        const envName = name || resolvedName || config.defaultEnvironment;
+        if (!envName) {
+            error(`No environment specified and no defaultEnvironment set. Usage: primitive env show <name>`);
+            process.exit(1);
+        }
+        const e = config.environments[envName];
+        if (!e) {
+            error(`Environment "${envName}" does not exist.`);
+            process.exit(1);
+        }
+        if (options.json) {
+            json({ name: envName, ...e });
+            return;
+        }
+        divider();
+        printResult("Name", envName);
+        printResult("API URL", e.apiUrl);
+        if (e.appId)
+            printResult("App ID", e.appId);
+        if (e.appName)
+            printResult("App Name", e.appName);
+        if (e.description)
+            printResult("Description", e.description);
+        if (config.defaultEnvironment === envName) {
+            info(`(committed team default — "defaultEnvironment")`);
+        }
+        divider();
+    });
+}
+/**
+ * The project's `primitive/config.json`, or the one refusal.
+ *
+ * `env add` used to CREATE the file when the upward walk found none, so an
+ * environment could be added before `primitive init` had ever run. That was
+ * the fourth way to bring a configuration tree into being, and #3154 leaves
+ * exactly one: `primitive init`. It is also why the missing-config message may
+ * not offer `primitive env add` as a remedy — outside a project this command
+ * now fails with that very message.
+ */
+function requireExistingConfig() {
+    const existingPath = findProjectConfigPath();
+    if (!existingPath) {
+        error(missingConfigMessage(process.cwd()));
+        process.exit(1);
+    }
+    try {
+        return { path: existingPath, config: loadProjectConfig() };
+    }
+    catch (err) {
+        if (err instanceof ProjectConfigError) {
+            error(err.message);
+        }
+        else {
+            error(err.message || String(err));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/src/commands/env.js.map

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

package/dist/src/commands/feature-flags.d.ts

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+/**
+ * The platform's feature flags (issue #2803, phase 6).
+ *
+ * A feature flag is already what the rest of this issue is arguing for: one
+ * server-owned toggle with one writer. What it did not have was both surfaces —
+ * the console could flip a flag and the CLI could not read one, so an operator
+ * without a browser had no way to see or change platform behaviour.
+ *
+ * The model is unchanged (`enabled`, a boolean; not the five carrying types'
+ * `status`), and the routes already existed. This is the missing half of
+ * "every operational control is reachable from the CLI and from web-admin".
+ */
+export declare function registerFeatureFlagsCommands(program: Command): void;

package/dist/src/commands/feature-flags.js

@@ -0,0 +1,117 @@
+import { ApiClient } from "../lib/api-client.js";
+import { success, error, info, formatTable, formatBoolean, result as printResult, json, } from "../lib/output.js";
+import { wholeListEnvelope } from "../lib/paginate.js";
+/**
+ * The platform's feature flags (issue #2803, phase 6).
+ *
+ * A feature flag is already what the rest of this issue is arguing for: one
+ * server-owned toggle with one writer. What it did not have was both surfaces —
+ * the console could flip a flag and the CLI could not read one, so an operator
+ * without a browser had no way to see or change platform behaviour.
+ *
+ * The model is unchanged (`enabled`, a boolean; not the five carrying types'
+ * `status`), and the routes already existed. This is the missing half of
+ * "every operational control is reachable from the CLI and from web-admin".
+ */
+export function registerFeatureFlagsCommands(program) {
+    const flags = program
+        .command("feature-flags")
+        .description("Read and toggle platform feature flags (super-admin only)")
+        .addHelpText("after", `
+Examples:
+  $ primitive feature-flags list
+  $ primitive feature-flags get unified-block-canonical-storage
+  $ primitive feature-flags enable unified-block-canonical-storage
+  $ primitive feature-flags disable unified-block-canonical-storage
+
+A flag is platform state, not app configuration: it is not in the TOML tree and
+'config push' neither reads nor writes it.
+`);
+    flags
+        .command("list")
+        .description("List every feature flag and whether it is enabled")
+        .option("--json", "Output as JSON")
+        .action(async (options) => {
+        const client = new ApiClient();
+        try {
+            const result = await client.listFeatureFlags();
+            const items = result?.items ?? result?.flags ?? result ?? [];
+            if (options.json) {
+                json(wholeListEnvelope(Array.isArray(items) ? items : []));
+                return;
+            }
+            if (!Array.isArray(items) || items.length === 0) {
+                info("No feature flags found.");
+                return;
+            }
+            console.log(formatTable(items, [
+                { header: "KEY", key: "flagKey" },
+                { header: "ENABLED", key: "enabled", format: formatBoolean },
+                { header: "DESCRIPTION", key: "description" },
+            ]));
+        }
+        catch (err) {
+            error(err.message);
+            process.exit(1);
+        }
+    });
+    flags
+        .command("get")
+        .description("Show one feature flag, including its per-app overrides")
+        .argument("<flag-key>", "Feature flag key")
+        .option("--json", "Output as JSON")
+        .action(async (flagKey, options) => {
+        const client = new ApiClient();
+        try {
+            const flag = await client.getFeatureFlag(flagKey);
+            if (options.json) {
+                json(flag);
+                return;
+            }
+            printResult("Key", flag.flagKey);
+            printResult("Enabled", formatBoolean(flag.enabled));
+            printResult("Description", flag.description || "-");
+            // The per-app overrides are what make a flag's effective value differ
+            // from the global one, so `get` shows them rather than only the global.
+            printResult("Enabled for apps", Array.isArray(flag.enabledAppIds) && flag.enabledAppIds.length > 0
+                ? flag.enabledAppIds.join(", ")
+                : "-");
+            printResult("Disabled for apps", Array.isArray(flag.disabledAppIds) && flag.disabledAppIds.length > 0
+                ? flag.disabledAppIds.join(", ")
+                : "-");
+        }
+        catch (err) {
+            error(err.message);
+            process.exit(1);
+        }
+    });
+    for (const [verb, enabled] of [
+        ["enable", true],
+        ["disable", false],
+    ]) {
+        flags
+            .command(verb)
+            .description(enabled
+            ? "Turn a feature flag on globally"
+            : "Turn a feature flag off globally")
+            .argument("<flag-key>", "Feature flag key")
+            .option("--json", "Output as JSON")
+            .action(async (flagKey, options) => {
+            const client = new ApiClient();
+            try {
+                const flag = await client.setFeatureFlagEnabled(flagKey, enabled);
+                if (options.json) {
+                    json(flag);
+                    return;
+                }
+                success(`Feature flag ${enabled ? "enabled" : "disabled"}: ${flagKey}`);
+                info("Per-app overrides still apply — `primitive feature-flags get` shows them.");
+            }
+            catch (err) {
+                error(err.message);
+                process.exit(1);
+            }
+        });
+    }
+}
+//# sourceMappingURL=feature-flags.js.map

package/dist/src/commands/feature-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.js","sourceRoot":"","sources":["../../../src/commands/feature-flags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,OAAO,EACP,KAAK,EACL,IAAI,EACJ,WAAW,EACX,aAAa,EACb,MAAM,IAAI,WAAW,EACrB,IAAI,GACL,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,2DAA2D,CAAC;SACxE,WAAW,CACV,OAAO,EACP;;;;;;;;;CASL,CACI,CAAC;IAEJ,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,IAAI,MAAM,IAAI,EAAE,CAAC;YAC7D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3D,OAAO;YACT,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAAG,CACT,WAAW,CAAC,KAAK,EAAE;gBACjB,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE;gBACjC,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE;gBAC5D,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE;aAC9C,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,wDAAwD,CAAC;SACrE,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;SAC1C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACX,OAAO;YACT,CAAC;YACD,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,WAAW,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACpD,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;YACpD,sEAAsE;YACtE,wEAAwE;YACxE,WAAW,CACT,kBAAkB,EAClB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBAChE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC/B,CAAC,CAAC,GAAG,CACR,CAAC;YACF,WAAW,CACT,mBAAmB,EACnB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAClE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;gBAChC,CAAC,CAAC,GAAG,CACR,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI;QAC5B,CAAC,QAAQ,EAAE,IAAI,CAAC;QAChB,CAAC,SAAS,EAAE,KAAK,CAAC;KACV,EAAE,CAAC;QACX,KAAK;aACF,OAAO,CAAC,IAAI,CAAC;aACb,WAAW,CACV,OAAO;YACL,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,kCAAkC,CACvC;aACA,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;aAC1C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;aAClC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAClE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,IAAI,CAAC,IAAI,CAAC,CAAC;oBACX,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,gBAAgB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;gBACxE,IAAI,CACF,2EAA2E,CAC5E,CAAC;YACJ,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC;AACH,CAAC"}

package/dist/src/commands/functions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `primitive functions` — server functions' read and operational verbs
+ * (#3179, project `server-functions`).
+ *
+ * A server function is the SIXTH status-carrying type (`docs/cli-design.md`,
+ * §Object availability): it exposes a public endpoint, so it carries
+ * `active | inactive | archived`, the `enable`/`disable` pair, and the
+ * `archive` spelling of the delete flow. It carries no `create`, `update` or
+ * `delete` verb — the function is authored in `functions/<key>.toml` beside the
+ * TypeScript its `entry` names, applied with `config push`, and prune-by-push
+ * stays the only CLI hard-delete path.
+ *
+ * The rule worth stating loudly here, because a function IS code on a public
+ * endpoint: a `config push` to a DISABLED function updates the code and leaves
+ * it out of service. `status` has one writer pair and push is not one of them
+ * (#2803's resurrection guard) — otherwise shipping a fix would silently put
+ * an endpoint an operator had taken down back in service.
+ */
+import { Command } from "commander";
+export declare function registerFunctionsCommands(program: Command): void;