@numa-tech/numa 1.22.1 → 1.23.1

package/dist/gitops/workload-input.js

@@ -0,0 +1,125 @@
+import { readFile, stat } from "node:fs/promises";
+import { GitOpsError, redactGitOpsText } from "./errors.js";
+const ROOTS = new Set(["/replicaCount", "/resources", "/env", "/envs", "/envFrom", "/service", "/ingress",
+    "/livenessProbe", "/readinessProbe", "/startupProbe", "/image/repository", "/image/tag"]);
+const SENSITIVE = /(?:password|passwd|secret|token|credential|api.?key|access.?key|private.?key)/iu;
+const SECRET_REFERENCES = new Set(["secretKeyRef", "secretRef"]);
+const SECRET_REFERENCE_NAMES = new Set(["secretName", "existingSecret"]);
+const MAX_BYTES = 1024 * 1024;
+export function workloadInteger(value, name, minimum = 0) {
+    if (!/^(0|[1-9][0-9]*)$/u.test(value) || !Number.isSafeInteger(Number(value)) || Number(value) < minimum) {
+        throw new GitOpsError(`${name} must be an integer of at least ${minimum}.`, "GITOPS_CLI_INPUT_INVALID");
+    }
+    return Number(value);
+}
+export async function readWorkloadJson(path) {
+    try {
+        const info = await stat(path);
+        if (!info.isFile() || info.size > MAX_BYTES)
+            throw new Error("size");
+        const text = await readFile(path, "utf8");
+        if (Buffer.byteLength(text) > MAX_BYTES)
+            throw new Error("size");
+        return JSON.parse(text);
+    }
+    catch {
+        throw new GitOpsError("Configuration input must be a valid JSON file no larger than 1 MiB.", "GITOPS_SPEC_INVALID");
+    }
+}
+function rejectSecrets(value, reference = false) {
+    if (Array.isArray(value)) {
+        value.forEach((item) => rejectSecrets(item));
+        return;
+    }
+    if (!value || typeof value !== "object")
+        return;
+    const object = value;
+    if (String(object.kind ?? "").toLowerCase() === "secret" && ("data" in object || "stringData" in object)) {
+        throw new GitOpsError("Secret values are forbidden; supply an existing Secret reference.", "GITOPS_SECRET_DATA_FORBIDDEN");
+    }
+    if (typeof object.name === "string" && SENSITIVE.test(object.name) && "value" in object) {
+        throw new GitOpsError("Sensitive environment values require valueFrom.secretKeyRef.", "GITOPS_SECRET_DATA_FORBIDDEN");
+    }
+    for (const [key, item] of Object.entries(object)) {
+        if (["__proto__", "constructor", "prototype"].includes(key)) {
+            throw new GitOpsError("Unsafe configuration key.", "GITOPS_SPEC_INVALID");
+        }
+        if (!reference && SENSITIVE.test(key) && !SECRET_REFERENCES.has(key) && !SECRET_REFERENCE_NAMES.has(key) && item != null && typeof item !== "object") {
+            throw new GitOpsError("Sensitive configuration values require an existing Secret reference.", "GITOPS_SECRET_DATA_FORBIDDEN");
+        }
+        rejectSecrets(item, SECRET_REFERENCES.has(key));
+    }
+}
+export function validateWorkloadChanges(input) {
+    if (!Array.isArray(input) || input.length === 0 || input.length > 40) {
+        throw new GitOpsError("changes must be a non-empty JSON array with at most 40 pointer/value entries.", "GITOPS_SPEC_INVALID");
+    }
+    const pointers = [];
+    return input.map((raw) => {
+        if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+            throw new GitOpsError("Every change must contain pointer and value.", "GITOPS_SPEC_INVALID");
+        }
+        const change = raw;
+        if (Object.keys(change).some((key) => key !== "pointer" && key !== "value") || !Object.hasOwn(change, "value")) {
+            throw new GitOpsError("Only pointer and value are accepted in a change.", "GITOPS_SPEC_INVALID");
+        }
+        const pointer = change.pointer;
+        if (typeof pointer !== "string" || (!ROOTS.has(pointer)
+            && !/^\/resources\/(?:requests|limits)\/(?:cpu|memory|ephemeral-storage)$/u.test(pointer)
+            && !/^\/service\/(?:type|port|targetPort)$/u.test(pointer))) {
+            throw new GitOpsError("Unsupported configuration pointer; use replicas, resources, env, probes, service, ingress or image fields.", "GITOPS_SPEC_INVALID");
+        }
+        if (pointers.some((previous) => previous === pointer || previous.startsWith(`${pointer}/`) || pointer.startsWith(`${previous}/`))) {
+            throw new GitOpsError("Duplicate or overlapping configuration pointers are not allowed.", "GITOPS_SPEC_INVALID");
+        }
+        pointers.push(pointer);
+        if (pointer === "/replicaCount" && (!Number.isInteger(change.value) || Number(change.value) < 0 || Number(change.value) > 10000)) {
+            throw new GitOpsError("replicas must be an integer between 0 and 10000.", "GITOPS_CLI_INPUT_INVALID");
+        }
+        if (pointer.startsWith("/image/") && (typeof change.value !== "string" || !change.value.trim() || /[\s\u0000-\u001f]/u.test(change.value))) {
+            throw new GitOpsError("Image repository/tag must be a non-empty value without whitespace.", "GITOPS_CLI_INPUT_INVALID");
+        }
+        rejectSecrets(change.value);
+        return { pointer, value: change.value };
+    });
+}
+export async function workloadChanges(options) {
+    const changes = [];
+    if (options.changes) {
+        const input = await readWorkloadJson(options.changes);
+        if (!Array.isArray(input))
+            throw new GitOpsError("changes file must contain an array.", "GITOPS_SPEC_INVALID");
+        changes.push(...input);
+    }
+    if (options.replicas != null)
+        changes.push({ pointer: "/replicaCount", value: workloadInteger(options.replicas, "replicas") });
+    if (options.imageRepository != null)
+        changes.push({ pointer: "/image/repository", value: options.imageRepository });
+    if (options.imageTag != null)
+        changes.push({ pointer: "/image/tag", value: options.imageTag });
+    for (const key of ["resources", "env", "envs", "envFrom", "service", "ingress", "livenessProbe", "readinessProbe", "startupProbe"]) {
+        if (options[key])
+            changes.push({ pointer: `/${key}`, value: await readWorkloadJson(options[key]) });
+    }
+    return validateWorkloadChanges(changes);
+}
+/** Preserve user configuration keys while converting only DTO metadata to CLI snake_case. */
+export function workloadPublicOutput(value, opaque = false) {
+    if (typeof value === "string")
+        return redactGitOpsText(value);
+    if (Array.isArray(value))
+        return value.map((item) => workloadPublicOutput(item, opaque));
+    if (!value || typeof value !== "object")
+        return value;
+    const object = value;
+    const sensitiveValue = (typeof object.name === "string" && SENSITIVE.test(object.name))
+        || (typeof object.pointer === "string" && SENSITIVE.test(object.pointer));
+    return Object.fromEntries(Object.entries(object).map(([key, item]) => {
+        const outputKey = opaque ? key : key.replace(/([a-z0-9])([A-Z])/gu, "$1_$2").toLowerCase();
+        const reference = SECRET_REFERENCES.has(key) || SECRET_REFERENCE_NAMES.has(key);
+        const redact = (sensitiveValue && ["value", "before", "after"].includes(key))
+            || (!reference && SENSITIVE.test(key));
+        return [outputKey, redact ? "[REDACTED]" : workloadPublicOutput(item, opaque || reference || ["value", "before", "after"].includes(key))];
+    }));
+}
+//# sourceMappingURL=workload-input.js.map

package/dist/gitops/workload-input.js.map

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

package/dist/gitops/workload-schemas.d.ts

@@ -0,0 +1,217 @@
+import { z } from "zod";
+export declare const GitOpsUnitInputSchema: z.ZodObject<{
+    unitKey: z.ZodString;
+    name: z.ZodString;
+    gitopsRepositoryId: z.ZodNumber;
+    branch: z.ZodString;
+    path: z.ZodString;
+    scope: z.ZodEnum<{
+        CLUSTER: "CLUSTER";
+        ENVIRONMENT: "ENVIRONMENT";
+        STANDALONE: "STANDALONE";
+    }>;
+    tier: z.ZodDefault<z.ZodEnum<{
+        DEVELOP: "DEVELOP";
+        PRODUCTION: "PRODUCTION";
+        STAGING: "STAGING";
+        UNKNOWN: "UNKNOWN";
+    }>>;
+    environmentId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    clusterId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fluxInstallationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    targetId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        DISABLED: "DISABLED";
+    }>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export declare const GitOpsUnitSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    unitKey: z.ZodString;
+    name: z.ZodString;
+    gitopsRepositoryId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    branch: z.ZodString;
+    path: z.ZodString;
+    scope: z.ZodEnum<{
+        CLUSTER: "CLUSTER";
+        ENVIRONMENT: "ENVIRONMENT";
+        STANDALONE: "STANDALONE";
+    }>;
+    tier: z.ZodEnum<{
+        DEVELOP: "DEVELOP";
+        PRODUCTION: "PRODUCTION";
+        STAGING: "STAGING";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    environmentId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    clusterId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    fluxInstallationId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    targetId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    status: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        DISABLED: "DISABLED";
+    }>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    version: z.ZodNumber;
+}, z.core.$strip>;
+export declare const GitOpsUnitListSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    unitKey: z.ZodString;
+    name: z.ZodString;
+    gitopsRepositoryId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    branch: z.ZodString;
+    path: z.ZodString;
+    scope: z.ZodEnum<{
+        CLUSTER: "CLUSTER";
+        ENVIRONMENT: "ENVIRONMENT";
+        STANDALONE: "STANDALONE";
+    }>;
+    tier: z.ZodEnum<{
+        DEVELOP: "DEVELOP";
+        PRODUCTION: "PRODUCTION";
+        STAGING: "STAGING";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    environmentId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    clusterId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    fluxInstallationId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    targetId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    status: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        DISABLED: "DISABLED";
+    }>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    version: z.ZodNumber;
+}, z.core.$strip>>;
+export type GitOpsUnitInput = z.infer<typeof GitOpsUnitInputSchema>;
+export declare const GitOpsWorkloadSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    unitId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    serviceName: z.ZodString;
+    namespace: z.ZodString;
+    ownerTeamId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    applicationId: z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+    basePath: z.ZodString;
+    overlayPath: z.ZodString;
+    status: z.ZodString;
+    version: z.ZodNumber;
+    configRevision: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const GitOpsWorkloadListSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        unitId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        serviceName: z.ZodString;
+        namespace: z.ZodString;
+        ownerTeamId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        applicationId: z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+        basePath: z.ZodString;
+        overlayPath: z.ZodString;
+        status: z.ZodString;
+        version: z.ZodNumber;
+        configRevision: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    pageSize: z.ZodNumber;
+}, z.core.$strip>;
+export declare const GitOpsWorkloadDiscoverySchema: z.ZodObject<{
+    unitId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    revision: z.ZodString;
+    total: z.ZodNumber;
+    page: z.ZodNumber;
+    pageSize: z.ZodNumber;
+    candidates: z.ZodArray<z.ZodObject<{
+        serviceName: z.ZodString;
+        namespace: z.ZodString;
+        basePath: z.ZodString;
+        overlayPath: z.ZodString;
+        managedWorkloadId: z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+        editable: z.ZodBoolean;
+        issues: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const GitOpsWorkloadConfigurationSchema: z.ZodObject<{
+    workload: z.ZodObject<{
+        id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        unitId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        serviceName: z.ZodString;
+        namespace: z.ZodString;
+        ownerTeamId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        applicationId: z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>;
+        basePath: z.ZodString;
+        overlayPath: z.ZodString;
+        status: z.ZodString;
+        version: z.ZodNumber;
+        configRevision: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    revision: z.ZodString;
+    valuesResolved: z.ZodBoolean;
+    workloadRendered: z.ZodLiteral<false>;
+    layers: z.ZodArray<z.ZodObject<{
+        file: z.ZodNullable<z.ZodString>;
+        pointer: z.ZodString;
+        role: z.ZodString;
+    }, z.core.$strip>>;
+    references: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodString;
+        valuesKey: z.ZodString;
+        sourceFile: z.ZodNullable<z.ZodString>;
+        resolved: z.ZodBoolean;
+    }, z.core.$strip>>;
+    fields: z.ZodArray<z.ZodObject<{
+        pointer: z.ZodString;
+        value: z.ZodJSONSchema;
+        source: z.ZodNullable<z.ZodObject<{
+            file: z.ZodNullable<z.ZodString>;
+            pointer: z.ZodString;
+            role: z.ZodString;
+        }, z.core.$strip>>;
+        editable: z.ZodBoolean;
+        owner: z.ZodString;
+    }, z.core.$strip>>;
+    issues: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const GitOpsWorkloadPlanSchema: z.ZodObject<{
+    planNumber: z.ZodString;
+    workloadId: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    planHash: z.ZodString;
+    state: z.ZodEnum<{
+        APPLYING: "APPLYING";
+        FAILED: "FAILED";
+        PLANNED: "PLANNED";
+        STALE: "STALE";
+        SUCCEEDED: "SUCCEEDED";
+        WAITING_REVIEW: "WAITING_REVIEW";
+    }>;
+    baseRevision: z.ZodString;
+    resultRevision: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reviewUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    changes: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        pointer: z.ZodString;
+        before: z.ZodJSONSchema;
+        after: z.ZodJSONSchema;
+    }, z.core.$strip>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        operation: z.ZodEnum<{
+            CREATE: "CREATE";
+            DELETE: "DELETE";
+            UPDATE: "UPDATE";
+        }>;
+        beforeDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        afterDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    issues: z.ZodArray<z.ZodString>;
+    failureCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    failureReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type GitOpsWorkloadChange = {
+    pointer: string;
+    value: z.infer<ReturnType<typeof z.json>>;
+};
+export type GitOpsWorkloadPlan = z.infer<typeof GitOpsWorkloadPlanSchema>;

package/dist/gitops/workload-schemas.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+const Identifier = z.union([z.string().trim().min(1), z.number().int().positive()]).transform(String);
+const Text = z.string().min(1);
+const NullableText = z.string().nullable().optional();
+const Source = z.object({ file: z.string().nullable(), pointer: z.string(), role: z.string() });
+const UnitScope = z.enum(["ENVIRONMENT", "CLUSTER", "STANDALONE"]);
+export const GitOpsUnitInputSchema = z.object({
+    unitKey: Text, name: Text, gitopsRepositoryId: z.number().int().positive(),
+    branch: Text, path: Text, scope: UnitScope,
+    tier: z.enum(["DEVELOP", "STAGING", "PRODUCTION", "UNKNOWN"]).default("UNKNOWN"),
+    environmentId: z.number().int().positive().nullable().optional(),
+    clusterId: z.number().int().positive().nullable().optional(),
+    fluxInstallationId: z.number().int().positive().nullable().optional(),
+    targetId: z.number().int().positive().nullable().optional(),
+    status: z.enum(["ACTIVE", "DISABLED"]).default("ACTIVE"), description: NullableText
+}).strict();
+export const GitOpsUnitSchema = z.object({
+    id: Identifier, unitKey: Text, name: Text, gitopsRepositoryId: Identifier,
+    branch: Text, path: Text, scope: UnitScope,
+    tier: z.enum(["DEVELOP", "STAGING", "PRODUCTION", "UNKNOWN"]),
+    environmentId: Identifier.nullable().optional(), clusterId: Identifier.nullable().optional(),
+    fluxInstallationId: Identifier.nullable().optional(), targetId: Identifier.nullable().optional(),
+    status: z.enum(["ACTIVE", "DISABLED"]), description: NullableText, version: z.number().int().nonnegative()
+});
+export const GitOpsUnitListSchema = z.array(GitOpsUnitSchema);
+export const GitOpsWorkloadSchema = z.object({
+    id: Identifier, unitId: Identifier, serviceName: Text,
+    namespace: z.string(),
+    ownerTeamId: Identifier, applicationId: Identifier.nullable(),
+    basePath: Text, overlayPath: Text, status: Text,
+    version: z.number().int().nonnegative(), configRevision: NullableText
+});
+export const GitOpsWorkloadListSchema = z.object({
+    items: z.array(GitOpsWorkloadSchema), total: z.number().int().nonnegative(),
+    page: z.number().int().positive(), pageSize: z.number().int().positive()
+});
+export const GitOpsWorkloadDiscoverySchema = z.object({
+    unitId: Identifier, revision: Text, total: z.number().int().nonnegative(),
+    page: z.number().int().positive(), pageSize: z.number().int().positive(),
+    candidates: z.array(z.object({
+        serviceName: Text, namespace: z.string(), basePath: Text, overlayPath: Text,
+        managedWorkloadId: Identifier.nullable(), editable: z.boolean(), issues: z.array(z.string())
+    }))
+});
+export const GitOpsWorkloadConfigurationSchema = z.object({
+    workload: GitOpsWorkloadSchema, revision: Text,
+    valuesResolved: z.boolean(), workloadRendered: z.literal(false),
+    layers: z.array(Source),
+    references: z.array(z.object({
+        kind: z.string(), name: z.string(), valuesKey: z.string(), sourceFile: z.string().nullable(), resolved: z.boolean()
+    })),
+    fields: z.array(z.object({
+        pointer: z.string(), value: z.json(), source: Source.nullable(), editable: z.boolean(), owner: z.string()
+    })),
+    issues: z.array(z.string())
+});
+export const GitOpsWorkloadPlanSchema = z.object({
+    planNumber: Text, workloadId: Identifier, planHash: z.string().regex(/^[a-f0-9]{64}$/u),
+    state: z.enum(["PLANNED", "APPLYING", "SUCCEEDED", "WAITING_REVIEW", "STALE", "FAILED"]),
+    baseRevision: Text, resultRevision: NullableText, reviewUrl: NullableText,
+    changes: z.array(z.object({ file: Text, pointer: z.string(), before: z.json(), after: z.json() })),
+    files: z.array(z.object({
+        path: Text, operation: z.enum(["CREATE", "UPDATE", "DELETE"]),
+        beforeDigest: NullableText, afterDigest: NullableText
+    })),
+    issues: z.array(z.string()), failureCode: NullableText, failureReason: NullableText, expiresAt: NullableText
+});
+//# sourceMappingURL=workload-schemas.js.map

package/dist/gitops/workload-schemas.js.map

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

package/dist/interactive/prompts.d.ts

@@ -5,7 +5,7 @@ export interface Choice {
     hint?: string;
 }
 export interface InstallUi {
-    choose(message: string, choices: Choice[], initial?: string): Promise<string>;
+    choose(message: string, choices: Choice[], initial?: string, shortcut?: Choice): Promise<string>;
     multiple(message: string, choices: Choice[], initial?: string[]): Promise<string[]>;
     text(message: string, initial?: string): Promise<string>;
     secret(message: string): Promise<string>;
@@ -17,10 +17,12 @@ export declare class InstallCancelled extends AiRegistryError {
 }
 export declare function safeTerminal(value: string): string;
 export declare const terminalUi: InstallUi;
+/** Tab exits only this prompt, then the caller opens its existing menu. */
+export declare function chooseWithShortcut(shortcut: Choice | undefined, prompt: (signal?: AbortSignal, input?: NodeJS.ReadStream) => Promise<string | symbol>, input?: NodeJS.ReadStream): Promise<string>;
 export declare function useInteractive(options: {
     interactive?: boolean;
 }, missing: boolean, json: boolean, tty?: boolean): boolean;
 export declare function requireInput(condition: unknown, message: string): asserts condition;
-export declare function confirmInstall(ui: InstallUi, plan: unknown): Promise<void>;
+export declare function confirmInstall(ui: InstallUi, plan: unknown, message?: string): Promise<void>;
 export declare function startWizard(title: string): void;
 export declare function chooseEnvironment(ui: InstallUi, existing?: string[]): Promise<string[]>;

package/dist/interactive/prompts.js

@@ -1,6 +1,7 @@
 import { autocomplete, autocompleteMultiselect, text, confirm, note, isCancel, intro, password, } from "@clack/prompts";
 import { safeMcpOutput, parseEnvironment } from "../mcp/environment.js";
 import { AiRegistryError } from "../ai-registry/errors.js";
+import { Transform } from "node:stream";
 export class InstallCancelled extends AiRegistryError {
     constructor() {
         super("已取消安装；尚未确认的操作不会执行。", "cli_cancelled");
@@ -15,8 +16,8 @@ function value(answer) {
     return answer;
 }
 export const terminalUi = {
-    choose: async (message, options, initialValue) => value(await autocomplete({
-        message,
+    choose: async (message, options, initialValue, shortcut) => chooseWithShortcut(shortcut, (signal, input) => autocomplete({
+        message: shortcut ? `${message} · Tab ${shortcut.label}` : message,
         options: options.map((o) => ({
             ...o,
             label: safeTerminal(o.label),
@@ -24,6 +25,8 @@ export const terminalUi = {
         })),
         initialValue,
         output: process.stderr,
+        signal,
+        input,
         filter: (search, option) => `${option.label} ${option.hint ?? ""} ${option.value}`
             .toLowerCase()
             .includes(search.toLowerCase()),
@@ -43,6 +46,35 @@ export const terminalUi = {
     confirm: async (message) => value(await confirm({ message, initialValue: false, output: process.stderr })),
     note: (message, title) => note(message, title, { output: process.stderr }),
 };
+/** Tab exits only this prompt, then the caller opens its existing menu. */
+export async function chooseWithShortcut(shortcut, prompt, input = process.stdin) {
+    if (!shortcut)
+        return value(await prompt());
+    const controller = new AbortController();
+    let selected = false;
+    // Consume Tab before Clack's search input sees it. All other bytes retain
+    // the existing prompt's navigation, search and cancellation behavior.
+    const filtered = Object.assign(new Transform({
+        transform(chunk, _encoding, next) {
+            if (chunk.includes(9)) {
+                selected = true;
+                queueMicrotask(() => controller.abort());
+                next();
+            }
+            else
+                next(null, chunk);
+        },
+    }), { isTTY: input.isTTY, setRawMode: (mode) => input.setRawMode(mode) });
+    input.pipe(filtered);
+    try {
+        const answer = await prompt(controller.signal, filtered);
+        return selected ? shortcut.value : value(answer);
+    }
+    finally {
+        input.unpipe(filtered);
+        filtered.destroy();
+    }
+}
 export function useInteractive(options, missing, json, tty = Boolean(process.stdin.isTTY && process.stderr.isTTY)) {
     if (options.interactive === true && (json || !tty))
         throw new AiRegistryError("交互安装需要 TTY 且不能使用 --json；请提供完整参数，使用 --plan --json 核对。", "cli_interactive_required");
@@ -55,9 +87,9 @@ export function requireInput(condition, message) {
     if (!condition)
         throw new AiRegistryError(`${message}；交互终端可不带参数启动向导，脚本请提供完整参数。`, "cli_input_required");
 }
-export async function confirmInstall(ui, plan) {
+export async function confirmInstall(ui, plan, message = "按上述范围安装？") {
     ui.note(JSON.stringify(safeMcpOutput(plan), null, 2), "安装计划");
-    if (!(await ui.confirm("按上述范围安装？")))
+    if (!(await ui.confirm(message)))
         throw new InstallCancelled();
 }
 export function startWizard(title) {

package/dist/interactive/prompts.js.map

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

package/dist/interactive/registry-namespace.d.ts

@@ -0,0 +1,7 @@
+import type { AiRegistryClient } from "../ai-registry/client.js";
+import { type ResolveRegistryNamespaceOptions } from "../ai-registry/namespace.js";
+import { type InstallUi } from "./prompts.js";
+type NamespaceClient = Pick<AiRegistryClient, "getCapabilities" | "resolveNamespace">;
+export declare function chooseRegistryNamespace(client: NamespaceClient, options: ResolveRegistryNamespaceOptions, ui: InstallUi): Promise<import("../ai-registry/namespace.js").RegistryNamespaceContext>;
+export declare function initialRegistryNamespace(client: NamespaceClient, options: ResolveRegistryNamespaceOptions, ui: InstallUi): Promise<import("../ai-registry/namespace.js").RegistryNamespaceContext>;
+export {};

package/dist/interactive/registry-namespace.js

@@ -0,0 +1,51 @@
+import { AiRegistryError } from "../ai-registry/errors.js";
+import { resolveRegistryNamespace } from "../ai-registry/namespace.js";
+import { requireInput } from "./prompts.js";
+export async function chooseRegistryNamespace(client, options, ui) {
+    const capabilities = await client.getCapabilities();
+    const allowed = capabilities.namespaces.filter((n) => (!options.requiredAction || n.actions.includes(options.requiredAction)) &&
+        (!options.instance || n.instanceCode === options.instance));
+    requireInput(allowed.length, "当前身份没有可用的 namespace");
+    const selected = await ui.choose("更换 namespace：选择已授权的来源空间", allowed.map((n, i) => ({
+        value: String(i),
+        label: `${n.displayName} (${n.namespaceKey})`,
+        hint: `${n.instanceCode ?? "默认实例"} · ${n.environment}`,
+    })));
+    const n = allowed[Number(selected)];
+    requireInput(n, "请选择有效 namespace");
+    return active(await resolveRegistryNamespace(client, {
+        ...options, namespace: n.namespaceKey, instance: n.instanceCode ?? options.instance,
+    }));
+}
+export async function initialRegistryNamespace(client, options, ui) {
+    try {
+        const context = active(await resolveRegistryNamespace(client, options));
+        if (context.migratedInstance)
+            ui.note(`${context.namespace.namespaceKey}: ${context.migratedInstance.from} → ${context.migratedInstance.to}\n已更新项目来源并保留 .bak 备份；锁定版本及 SHA-256 不变。`, "旧配置已自动迁移");
+        return context;
+    }
+    catch (error) {
+        if (!(error instanceof AiRegistryError))
+            throw error;
+        if (error.code === "ai_registry_namespace_required")
+            return chooseRegistryNamespace(client, options, ui);
+        // Explicit CLI targets remain authoritative. A stale implicit default can
+        // recover only through a user's selection, never an automatic fallback.
+        if (options.namespace?.trim() || options.instance?.trim() || ![
+            "ai_registry_namespace_forbidden",
+            "ai_registry_namespace_ambiguous",
+            "ai_registry_action_forbidden",
+            "ai_registry_namespace_unavailable",
+        ].includes(error.code))
+            throw error;
+        ui.note(`${error.message}\n请选择本次使用的 namespace；项目清单、锁文件和默认配置保持不变。`, "默认来源不可用");
+        return chooseRegistryNamespace(client, options, ui);
+    }
+}
+function active(context) {
+    if (context.namespace.status !== "ACTIVE" || context.namespace.instanceStatus !== "ACTIVE") {
+        throw new AiRegistryError("所选来源未启用。", "ai_registry_namespace_unavailable");
+    }
+    return context;
+}
+//# sourceMappingURL=registry-namespace.js.map

package/dist/interactive/registry-namespace.js.map

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