feat: add staging environment support to CLI commands and validation

- Introduced new commands for staging environment: `apply:stg`, `push:stg`, `pull:stg`, `call:stg`, and `cleanup:stg`.
- Updated validation to include "stg" as a valid environment option, enhancing user guidance in error messages.
- Adjusted environment references in the codebase to use "stg" instead of "staging" for consistency.

Author: vtkovapi

package.json

@@ -6,18 +6,25 @@
   "private": true,
   "scripts": {
     "apply:dev": "tsx src/apply.ts dev",
+    "apply:stg": "tsx src/apply.ts stg",
     "apply:prod": "tsx src/apply.ts prod",
     "push:dev": "tsx src/push.ts dev",
+    "push:stg": "tsx src/push.ts stg",
     "push:prod": "tsx src/push.ts prod",
     "push:dev:force": "tsx src/push.ts dev --force",
+    "push:stg:force": "tsx src/push.ts stg --force",
     "push:prod:force": "tsx src/push.ts prod --force",
     "pull:dev": "tsx src/pull.ts dev",
+    "pull:stg": "tsx src/pull.ts stg",
     "pull:dev:force": "tsx src/pull.ts dev --force",
+    "pull:stg:force": "tsx src/pull.ts stg --force",
     "pull:prod": "tsx src/pull.ts prod",
     "pull:prod:force": "tsx src/pull.ts prod --force",
     "call:dev": "tsx src/call.ts dev",
+    "call:stg": "tsx src/call.ts stg",
     "call:prod": "tsx src/call.ts prod",
     "cleanup:dev": "tsx src/cleanup.ts dev",
+    "cleanup:stg": "tsx src/cleanup.ts stg",
     "cleanup:prod": "tsx src/cleanup.ts prod",
     "build": "tsc --noEmit"
   },

src/apply.ts

@@ -13,7 +13,7 @@ import { fileURLToPath } from "url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const BASE_DIR = join(__dirname, "..");
 
-const VALID_ENVIRONMENTS = ["dev", "staging", "prod"] as const;
+const VALID_ENVIRONMENTS = ["dev", "stg", "prod"] as const;
 
 function runPassthrough(cmd: string): number {
   try {
@@ -29,7 +29,7 @@ async function main(): Promise<void> {
   const extraArgs = process.argv.slice(3).join(" ");
 
   if (!env || !VALID_ENVIRONMENTS.includes(env as typeof VALID_ENVIRONMENTS[number])) {
-    console.error("Usage: npm run apply:dev | apply:prod");
+    console.error("Usage: npm run apply:dev | apply:stg | apply:prod");
     console.error("");
     console.error("  Pull → Merge → Push (safe bidirectional sync)");
     console.error("");

src/config.ts

@@ -31,7 +31,7 @@ function parseEnvironment(): Environment {
 
   if (!envArg) {
     console.error("❌ Environment argument is required");
-    console.error("   Usage: npm run apply:dev | apply:prod");
+    console.error("   Usage: npm run apply:dev | apply:stg | apply:prod");
     console.error("   Flags: --force (enable deletions)");
     console.error("          --type <type> (apply only specific resource type)");
     console.error("          -- <file...> (apply only specific files)");
@@ -127,7 +127,7 @@ function parseFlags(): { forceDelete: boolean; applyFilter: ApplyFilter } {
 
 function loadEnvFile(env: string, baseDir: string): void {
   const envFiles = [
-    join(baseDir, `.env.${env}`),       // .env.dev, .env.staging, .env.prod
+    join(baseDir, `.env.${env}`),       // .env.dev, .env.stg, .env.prod
     join(baseDir, `.env.${env}.local`), // .env.dev.local (for local overrides)
     join(baseDir, ".env.local"),        // .env.local (always loaded last)
   ];

src/types.ts

@@ -34,9 +34,9 @@ export type ResourceType =
   | "simulations"
   | "simulationSuites";
 
-export type Environment = "dev" | "staging" | "prod";
+export type Environment = "dev" | "stg" | "prod";
 
-export const VALID_ENVIRONMENTS: readonly Environment[] = ["dev", "staging", "prod"];
+export const VALID_ENVIRONMENTS: readonly Environment[] = ["dev", "stg", "prod"];
 
 export const VALID_RESOURCE_TYPES: readonly ResourceType[] = [
   "tools",