primitive-admin 1.1.0-alpha.7 → 1.1.0-alpha.71

package/dist/src/commands/env.js

@@ -0,0 +1,333 @@
+/**
+ * `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 { join, dirname } from "path";
+import { CURRENT_CONFIG_VERSION, PROJECT_CONFIG_DIR, PROJECT_CONFIG_FILENAME, PROJECT_CONFIG_DISPLAY_NAME, ProjectConfigError, findProjectConfigPath, loadProjectConfig, saveProjectConfig, } from "../lib/project-config.js";
+import { getCurrentEnvironment, resetEnvResolver, } from "../lib/env-resolver.js";
+import { PrimitiveEnvError, localStatePathForConfigPath, readLocalSelection, } from "../lib/env-resolver-core.js";
+import { clearLocalSelection, ensureLocalStateIgnored, writeLocalSelection, } from "../lib/local-state.js";
+import { clearCredentialsForEnvInProject } from "../lib/credentials-store.js";
+import { validateServerUrl } from "../lib/server-url.js";
+import { error, info, keyValue, result as printResult, success, warn, json, formatTable, divider, } from "../lib/output.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(`No ${PROJECT_CONFIG_DISPLAY_NAME} found in this directory or any parent. Run 'primitive init' to create one.`);
+        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://...       # add an environment
+  $ primitive env use prod                             # select it on this machine
+  $ primitive env show dev                             # show env details
+  $ primitive env remove staging                       # remove an environment
+`);
+    // 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 || "(unset)",
+            current: name === current ? "*" : "",
+            default: name === config.defaultEnvironment ? "*" : "",
+        }));
+        if (options.json) {
+            json({
+                currentEnvironment: current,
+                selectedEnvironment: selected,
+                defaultEnvironment: config.defaultEnvironment || null,
+                environments: config.environments,
+            });
+            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")
+        .option("--app-id <id>", "Optional app ID bound to this environment")
+        .option("--app-name <name>", "Optional app name (display only)")
+        .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 URL before touching disk.
+        if (validateServerUrl(options.apiUrl) !== true) {
+            error(`Invalid --api-url: ${options.apiUrl}`);
+            process.exit(1);
+        }
+        let { path, config, created } = findOrCreateConfig();
+        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: options.appId,
+            appName: options.appName,
+            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);
+        if (created) {
+            info(`Created ${PROJECT_CONFIG_DISPLAY_NAME} in ${dirname(dirname(path))}`);
+        }
+        success(`Added environment "${name}".`);
+        keyValue("API URL", config.environments[name].apiUrl);
+        if (options.appId)
+            keyValue("App ID", options.appId);
+        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 project root is two levels up from .primitive/config.json.
+        clearCredentialsForEnvInProject(dirname(dirname(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);
+        }
+        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();
+    });
+}
+/**
+ * Finds an existing .primitive/config.json (searching upward) or creates a
+ * fresh one in the current working directory. Used by `env add` so users can
+ * add an environment before running `primitive init` — this is nice
+ * ergonomics for people who want to add envs to an existing project.
+ */
+function findOrCreateConfig() {
+    const existingPath = findProjectConfigPath();
+    if (existingPath) {
+        try {
+            const config = loadProjectConfig();
+            return { path: existingPath, config };
+        }
+        catch (err) {
+            if (err instanceof ProjectConfigError) {
+                error(err.message);
+            }
+            else {
+                error(err.message || String(err));
+            }
+            process.exit(1);
+        }
+    }
+    const newPath = join(process.cwd(), PROJECT_CONFIG_DIR, PROJECT_CONFIG_FILENAME);
+    const config = {
+        version: CURRENT_CONFIG_VERSION,
+        environments: {},
+    };
+    return { path: newPath, config, created: true };
+}
+//# 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,116 @@
+import { ApiClient } from "../lib/api-client.js";
+import { success, error, info, formatTable, formatBoolean, result as printResult, json, } from "../lib/output.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(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;AAE1B;;;;;;;;;;;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,KAAK,CAAC,CAAC;gBACZ,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/group-type-configs.d.ts

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

package/dist/src/commands/group-type-configs.js

@@ -0,0 +1,86 @@
+import { ApiClient } from "../lib/api-client.js";
+import { resolveAppId } from "../lib/config.js";
+import { error, info, result as printResult, formatTable, formatDate, json, } from "../lib/output.js";
+export function registerGroupTypeConfigsCommands(program) {
+    const configs = program
+        .command("group-type-configs")
+        .description("Manage group type configurations (rule sets and auto-add behavior)")
+        .addHelpText("after", `
+Examples:
+  $ primitive group-type-configs list
+  $ primitive config create group-type-config team       # scaffold group-type-configs/team.toml
+  $ primitive config push --only group-type-config/team  # apply it
+  $ primitive group-type-configs get team
+  $ primitive config set group-type-config/team groupTypeConfig.autoAddCreator=false
+  $ primitive config push --only group-type-config/team
+`);
+    // Server-side configuration is authored in TOML and applied with `config push`
+    // (issue #2645) — this group no longer carries config-setting flags.
+    configs.addHelpText("after", `
+Configuration lives in group-type-configs/<type>.toml:
+  $ primitive config fields group-type-config        # the file's keys, types and defaults
+  $ primitive config create group-type-config <key>  # scaffold one locally
+  $ primitive config set group-type-config/<key> <path>=<value>
+  $ primitive config push --only group-type-config/<key>
+`);
+    // List
+    configs
+        .command("list")
+        .description("List group type configs in an app")
+        .argument("[app-id]", "App ID (uses current app if not specified)")
+        .option("--app <app-id>", "App ID")
+        .option("--json", "Output as JSON")
+        .action(async (appId, options) => {
+        const resolvedAppId = resolveAppId(appId, options);
+        const client = new ApiClient();
+        try {
+            const result = await client.listGroupTypeConfigs(resolvedAppId);
+            const list = Array.isArray(result) ? result : [];
+            if (options.json) {
+                json(list);
+                return;
+            }
+            if (list.length === 0) {
+                info("No group type configs found.");
+                return;
+            }
+            console.log(formatTable(list, [
+                { header: "GROUP_TYPE", key: "groupType" },
+                { header: "RULE_SET_ID", key: "ruleSetId" },
+                { header: "AUTO_ADD", key: "autoAddCreator" },
+                { header: "CREATED", key: "createdAt", format: formatDate },
+            ]));
+        }
+        catch (err) {
+            error(err.message);
+            process.exit(1);
+        }
+    });
+    configs
+        .command("get")
+        .description("Get a group type config")
+        .argument("<group-type>", "Group type")
+        .option("--app <app-id>", "App ID")
+        .option("--json", "Output as JSON")
+        .action(async (groupType, options) => {
+        const resolvedAppId = resolveAppId(undefined, options);
+        const client = new ApiClient();
+        try {
+            const result = await client.getGroupTypeConfig(resolvedAppId, groupType);
+            if (options.json) {
+                json(result);
+                return;
+            }
+            printResult("Group Type", result.groupType);
+            printResult("Rule Set ID", result.ruleSetId || "(none)");
+            printResult("Auto-Add Creator", String(result.autoAddCreator));
+            printResult("Created", formatDate(result.createdAt));
+            printResult("Modified", formatDate(result.modifiedAt));
+        }
+        catch (err) {
+            error(err.message);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=group-type-configs.js.map

package/dist/src/commands/group-type-configs.js.map

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

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

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