@sanity/runtime-cli 10.10.0 → 10.11.1

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/10.10.0 linux-x64 node-v22.20.0
+@sanity/runtime-cli/10.11.1 linux-x64 node-v22.20.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -33,6 +33,7 @@ USAGE
 * [`sanity-run blueprints config`](#sanity-run-blueprints-config)
 * [`sanity-run blueprints deploy`](#sanity-run-blueprints-deploy)
 * [`sanity-run blueprints destroy`](#sanity-run-blueprints-destroy)
+* [`sanity-run blueprints doctor`](#sanity-run-blueprints-doctor)
 * [`sanity-run blueprints info`](#sanity-run-blueprints-info)
 * [`sanity-run blueprints init [DIR]`](#sanity-run-blueprints-init-dir)
 * [`sanity-run blueprints logs`](#sanity-run-blueprints-logs)
@@ -88,7 +89,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-create --fn-type document-update --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -119,7 +120,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -141,7 +142,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -166,7 +167,25 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack-id <stackId> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/destroy.ts)_
+
+## `sanity-run blueprints doctor`
+
+Diagnose potential issues with Blueprint configuration
+
+```
+USAGE
+  $ sanity-run blueprints doctor [--verbose] [--path <value>]
+
+FLAGS
+  --path=<value>  Path to the Blueprint configuration file
+  --verbose       Provide detailed information about issues
+
+DESCRIPTION
+  Diagnose potential issues with Blueprint configuration
+```
+
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -188,7 +207,7 @@ EXAMPLES
   $ sanity-run blueprints info --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -226,7 +245,7 @@ EXAMPLES
   $ sanity-run blueprints init --blueprint-type <json|js|ts> --stack-name <stackName>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -248,7 +267,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -265,7 +284,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -287,7 +306,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --project-id <projectId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions dev`
 
@@ -309,7 +328,7 @@ EXAMPLES
   $ sanity-run functions dev --port 8974
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -331,7 +350,7 @@ EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -351,7 +370,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -372,7 +391,7 @@ EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs NAME`
 
@@ -406,7 +425,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test NAME`
 
@@ -453,7 +472,7 @@ EXAMPLES
   $ sanity-run functions test <name> --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v10.10.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v10.11.1/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/config.d.ts

@@ -4,7 +4,7 @@ export interface BlueprintsConfig {
     projectId?: string;
     stackId?: string;
 }
-export declare function readConfigFile(blueprintFilePath: string): BlueprintsConfig | null;
+export declare function readConfigFile(blueprintFilePath?: string): BlueprintsConfig | null;
 export declare function writeConfigFile({ blueprintFilePath, organizationId, projectId, stackId, }: {
     blueprintFilePath?: string;
     stackId?: string;

package/dist/actions/blueprints/config.js

@@ -3,7 +3,7 @@ import { dirname, join } from 'node:path';
 import { cwd } from 'node:process';
 import { BLUEPRINT_CONFIG_FILE, BLUEPRINT_CONFIG_VERSION, BLUEPRINT_DIR } from '../../config.js';
 export function readConfigFile(blueprintFilePath) {
-    const blueprintDir = dirname(blueprintFilePath);
+    const blueprintDir = blueprintFilePath ? dirname(blueprintFilePath) : cwd();
     const configPath = join(blueprintDir, BLUEPRINT_DIR, BLUEPRINT_CONFIG_FILE);
     if (existsSync(configPath)) {
         try {
@@ -14,16 +14,7 @@ export function readConfigFile(blueprintFilePath) {
             return null;
         }
     }
-    const configFilePath = join(cwd(), BLUEPRINT_DIR, BLUEPRINT_CONFIG_FILE);
-    if (!existsSync(configFilePath))
-        return null;
-    try {
-        const config = JSON.parse(readFileSync(configFilePath, 'utf8'));
-        return config || null;
-    }
-    catch {
-        return null;
-    }
+    return null;
 }
 export function writeConfigFile({ blueprintFilePath, organizationId, projectId, stackId, }) {
     const blueprintDir = blueprintFilePath ? dirname(blueprintFilePath) : cwd();

package/dist/actions/blueprints/index.js

@@ -33,11 +33,20 @@ export async function getBlueprintAndStack({ token, blueprintPath, }) {
             issues.push({ code: 'NO_STACK_ID', message: 'Stack ID not found' });
         return { localBlueprint, issues };
     }
-    const auth = { token, projectId };
-    const { error, ok, stack: deployedStack } = await getStack({ stackId, auth });
-    if (!ok) {
-        issues.push({ code: 'NO_STACK', message: error || 'Unknown error' });
+    const stackResponse = await getStack({
+        stackId,
+        auth: {
+            scopeType: 'project',
+            scopeId: projectId,
+            token,
+        },
+    });
+    if (!stackResponse.ok) {
+        issues.push({ code: 'NO_STACK', message: stackResponse.error || 'Unknown error' });
         return { localBlueprint, issues };
     }
-    return { localBlueprint: localBlueprint, deployedStack };
+    return {
+        localBlueprint: localBlueprint,
+        deployedStack: stackResponse.stack,
+    };
 }

package/dist/actions/blueprints/stacks.d.ts

@@ -1,4 +1,4 @@
-import type { AuthParams, Stack, StackMutation } from '../../utils/types.js';
+import type { AuthParams, ScopeType, Stack, StackMutation } from '../../utils/types.js';
 export declare const stacksUrl: string;
 interface ListStacksResponse {
     ok: boolean;
@@ -10,6 +10,7 @@ interface GetStackResponse {
     ok: boolean;
     error: string | null;
     stack: Stack;
+    response?: Response;
 }
 export declare function getStack({ stackId, auth, }: {
     stackId: string;
@@ -24,9 +25,10 @@ export declare function createStack({ stackMutation, auth, }: {
     stackMutation: StackMutation;
     auth: AuthParams;
 }): Promise<CreateStackResponse>;
-export declare function createEmptyStack({ token, projectId, name, projectBased, }: {
+export declare function createEmptyStack({ token, scopeType, scopeId, name, projectBased, }: {
     token: string;
-    projectId: string;
+    scopeType: ScopeType;
+    scopeId: string;
     name: string;
     projectBased?: boolean;
 }): Promise<Stack>;

package/dist/actions/blueprints/stacks.js

@@ -2,6 +2,7 @@ import config from '../../config.js';
 import getHeaders from '../../utils/get-headers.js';
 const { apiUrl } = config;
 export const stacksUrl = `${apiUrl}vX/blueprints/stacks`;
+/** Discriminate between Resource and Resource with parameters */
 function hasParameters(obj) {
     return (typeof obj === 'object' &&
         obj !== null &&
@@ -9,6 +10,7 @@ function hasParameters(obj) {
         typeof obj.parameters === 'object' &&
         obj.parameters !== null);
 }
+/** Flatten Resource with parameters */
 function flattenResource(resource) {
     if (hasParameters(resource)) {
         const { parameters, ...rest } = resource;
@@ -16,6 +18,7 @@ function flattenResource(resource) {
     }
     return resource;
 }
+/** Flatten a Stack's resources */
 function flattenStackResources(stack) {
     if (stack && Array.isArray(stack.resources)) {
         return {
@@ -47,6 +50,7 @@ export async function getStack({ stackId, auth, }) {
         ok: response.ok,
         error: response.ok ? null : data.message,
         stack: response.ok ? flattenStackResources(data) : data,
+        response,
     };
 }
 export async function createStack({ stackMutation, auth, }) {
@@ -62,15 +66,18 @@ export async function createStack({ stackMutation, auth, }) {
         stack: response.ok ? flattenStackResources(data) : data,
     };
 }
-export async function createEmptyStack({ token, projectId, name, projectBased = true, }) {
+export async function createEmptyStack({ token, scopeType, scopeId, name, projectBased = true, }) {
     const stackMutation = {
         name,
-        projectId,
+        scopeType,
+        scopeId,
         useProjectBasedId: projectBased,
         document: { resources: [] },
     };
-    const auth = { token, projectId };
-    const response = await createStack({ stackMutation, auth });
+    const response = await createStack({
+        stackMutation,
+        auth: { token, scopeType, scopeId },
+    });
     if (!response.ok) {
         throw new Error(response.error || 'Failed to create new Stack');
     }

package/dist/actions/sanity/projects.d.ts

@@ -1,3 +1,4 @@
+import type { ScopeType } from '../../utils/types.js';
 export declare const projectsApiPath: string;
 export declare const orgsApiPath: string;
 export interface Project {
@@ -40,8 +41,9 @@ interface GetProjectResponse {
     error: string | null;
     project: Project;
 }
-export declare function getProject({ token, projectId, }: {
+export declare function getProject({ token, scopeId, scopeType, }: {
     token: string;
-    projectId: string;
+    scopeId: string;
+    scopeType: ScopeType;
 }): Promise<GetProjectResponse>;
 export {};

package/dist/actions/sanity/projects.js

@@ -48,8 +48,11 @@ export async function groupProjectsByOrganization({ token, }) {
         organizations: orgsWithProjects,
     };
 }
-export async function getProject({ token, projectId, }) {
-    const response = await fetch(`${projectsApiPath}/${projectId}`, {
+export async function getProject({ token, scopeId, scopeType, }) {
+    if (scopeType !== 'project') {
+        throw new Error('Scope type must be project');
+    }
+    const response = await fetch(`${projectsApiPath}/${scopeId}`, {
         method: 'GET',
         headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
     });

package/dist/commands/blueprints/doctor.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class DoctorCommand extends Command {
+    static description: string;
+    static examples: never[];
+    static flags: {
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/blueprints/doctor.js

@@ -0,0 +1,28 @@
+import { Command, Flags } from '@oclif/core';
+import config from '../../config.js';
+import { blueprintDoctorCore } from '../../cores/blueprints/doctor.js';
+export default class DoctorCommand extends Command {
+    static description = 'Diagnose potential issues with Blueprint configuration';
+    static examples = [];
+    static flags = {
+        verbose: Flags.boolean({
+            description: 'Provide detailed information about issues',
+            default: false,
+        }),
+        path: Flags.string({
+            description: 'Path to the Blueprint configuration file',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DoctorCommand);
+        const { token } = config;
+        const { success, error } = await blueprintDoctorCore({
+            bin: this.config.bin,
+            log: (message) => this.log(message),
+            token,
+            flags,
+        });
+        if (!success)
+            this.error(error);
+    }
+}

package/dist/cores/blueprints/config.js

@@ -140,7 +140,7 @@ async function testConfigAndReport({ token, stackId, projectId, }) {
     const spinner = ora('Testing the configuration...').start();
     const { ok, error } = await getStack({
         stackId,
-        auth: { token, projectId },
+        auth: { token, scopeType: 'project', scopeId: projectId },
     });
     if (!ok) {
         spinner.fail('Configuration test failed.');
@@ -151,7 +151,7 @@ async function testConfigAndReport({ token, stackId, projectId, }) {
     return { ok, error };
 }
 async function startReinitializeStack({ token, projectId, }) {
-    const auth = { token, projectId };
+    const auth = { token, scopeType: 'project', scopeId: projectId };
     // stack id IS ST-${projectId} – it has already been checked and doesn't exist
     const { confirm } = await inquirer.prompt([
         {
@@ -170,8 +170,15 @@ async function startReinitializeStack({ token, projectId, }) {
         };
     }
     const projectDisplayName = project.displayName;
-    const stackMutation = { name: projectDisplayName, projectId, document: { resources: [] } };
-    const response = await createStack({ stackMutation, auth });
+    const response = await createStack({
+        stackMutation: {
+            name: projectDisplayName,
+            scopeType: 'project',
+            scopeId: projectId,
+            document: { resources: [] },
+        },
+        auth,
+    });
     if (!response.ok)
         return { ok: false, error: response.error || 'Failed to create new Stack' };
     return {

package/dist/cores/blueprints/deploy.js

@@ -46,14 +46,18 @@ export async function blueprintDeployCore(options) {
                 }
             }
         }
-        const stackMutation = {
-            projectId,
-            name: deployedStack.name,
-            document: { resources: validResources },
-        };
         const spinner = ora('Deploying...').start();
         const isoNow = new Date().toISOString();
-        const { ok: deployOk, stack, error: deployError, } = await updateStack({ stackId, stackMutation, auth });
+        const { ok: deployOk, stack, error: deployError, } = await updateStack({
+            stackId,
+            stackMutation: {
+                scopeType: 'project',
+                scopeId: projectId,
+                name: deployedStack.name,
+                document: { resources: validResources },
+            },
+            auth,
+        });
         if (!deployOk) {
             spinner.fail(`${chalk.red('Failed')} to update deployment`);
             return { success: false, error: deployError || 'Failed to update deployment' };

package/dist/cores/blueprints/destroy.js

@@ -12,7 +12,7 @@ export async function blueprintDestroyCore(options) {
     if (flagProjectId && flagStackId && force) {
         const { ok, error, stack } = await destroyStack({
             stackId: flagStackId,
-            auth: { token, projectId: flagProjectId },
+            auth: { token, scopeType: 'project', scopeId: flagProjectId },
         });
         if (!ok)
             return { success: false, error: error || 'Failed to destroy deployment' };
@@ -22,7 +22,7 @@ export async function blueprintDestroyCore(options) {
     const { projectId, stackId } = blueprint;
     if (!projectId)
         return { success: false, error: 'Project ID is required' };
-    const auth = { token, projectId };
+    const auth = { token, scopeType: 'project', scopeId: projectId };
     let stack;
     try {
         if (flagStackId) {

package/dist/cores/blueprints/doctor.d.ts

@@ -0,0 +1,9 @@
+import type { CoreConfig, CoreResult } from '../index.js';
+export interface BlueprintDoctorOptions extends CoreConfig {
+    token: string | null;
+    flags: {
+        verbose: boolean;
+        path: string | undefined;
+    };
+}
+export declare function blueprintDoctorCore(options: BlueprintDoctorOptions): Promise<CoreResult>;

package/dist/cores/blueprints/doctor.js

@@ -0,0 +1,188 @@
+import { cwd } from 'node:process';
+import chalk from 'chalk';
+import ora from 'ora';
+import { findBlueprintFile, readLocalBlueprint, } from '../../actions/blueprints/blueprint.js';
+import { getStack } from '../../actions/blueprints/stacks.js';
+import config from '../../config.js';
+import { check, indent, niceId, severe, warn } from '../../utils/display/presenters.js';
+import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
+const diagLookup = {
+    online: 'Online',
+    tokenPresent: 'Auth token present',
+    tokenValid: 'Auth token valid',
+    configFilePresent: 'Blueprints config file present',
+    configFileValid: 'Blueprints config file valid',
+    blueprintPresent: 'Blueprint file present',
+    blueprintValid: 'Blueprint file valid',
+    stackReady: 'Deployment "Stack" ready',
+    userHasAccess: 'User has access to "Stack"',
+};
+export async function blueprintDoctorCore(options) {
+    const { log, token, flags: { verbose: v, path: p }, } = options;
+    const yikes = (s) => {
+        log(chalk.bgRedBright.whiteBright.bold(` ${s} `));
+    };
+    const here = cwd();
+    const path = p || here;
+    if (v)
+        log(`Checking ${path}`);
+    // 3 states: null == unknown, true == good, false == bad
+    const diagnostics = {};
+    for (const key in diagLookup) {
+        diagnostics[key] = null;
+    }
+    let spinner;
+    if (!v)
+        spinner = ora('Checking environment').start();
+    // ONLINE
+    try {
+        const res = await fetch(config.apiUrl);
+        if (res.ok) {
+            if (v)
+                log(`Successfully pinged ${config.apiUrl}`);
+            diagnostics.online = res.ok;
+        }
+        else {
+            if (v)
+                yikes(`Failed to ping ${config.apiUrl}: ${res.status} ${res.statusText}`);
+            diagnostics.online = false;
+        }
+    }
+    catch {
+        if (v)
+            yikes(`Failed to ping ${config.apiUrl}`);
+    }
+    // TOKEN
+    if (token) {
+        diagnostics.tokenPresent = true;
+        const tokenOrError = await validTokenOrErrorMessage(token);
+        if (tokenOrError.ok) {
+            diagnostics.tokenValid = true;
+        }
+        else {
+            if (v)
+                yikes(`Token error: ${tokenOrError.error}`);
+            diagnostics.tokenValid = false;
+        }
+    }
+    else {
+        diagnostics.tokenPresent = false;
+    }
+    // BLUEPRINT file
+    const blueprintFile = findBlueprintFile(path);
+    if (blueprintFile?.blueprintFilePath) {
+        if (v)
+            log(`Found blueprint file at ${blueprintFile.blueprintFilePath.replace(here, '.')}`);
+        diagnostics.blueprintPresent = true;
+    }
+    else {
+        diagnostics.blueprintPresent = false;
+    }
+    let blueprint;
+    try {
+        blueprint = await readLocalBlueprint(path);
+        if (blueprint.errors.length === 0) {
+            if (v)
+                log(`Blueprint has no errors`);
+            diagnostics.blueprintValid = true;
+        }
+        else {
+            if (v)
+                log(`Blueprint errors: \n${blueprint.errors.join('\n  ')}`);
+            diagnostics.blueprintValid = false;
+        }
+    }
+    catch {
+        if (v)
+            yikes(`Unable to read blueprint`);
+        diagnostics.blueprintValid = false;
+    }
+    if (blueprint) {
+        const { configPath, scopeType, scopeId, stackId, projectId } = blueprint;
+        // CONFIG file
+        if (configPath) {
+            if (v)
+                log(`Found config file at ${configPath.replace(here, '.')}`);
+            diagnostics.configFilePresent = true;
+            if (scopeType && scopeId && stackId) {
+                diagnostics.configFileValid = true;
+                if (v) {
+                    const capitalizedScopeType = scopeType.charAt(0).toUpperCase() + scopeType.slice(1);
+                    const configOutput = [
+                        `${capitalizedScopeType}: ${niceId(scopeId)}`,
+                        `Deployment: ${niceId(stackId)}`,
+                    ].join('\n');
+                    log(indent(configOutput));
+                }
+            }
+            else {
+                diagnostics.configFileValid = false;
+            }
+        }
+        else {
+            diagnostics.configFilePresent = false;
+        }
+        // STACK + ACCESS
+        if (diagnostics.online && diagnostics.tokenValid && token && stackId && projectId) {
+            const stackResponse = await getStack({
+                auth: { token, scopeType: 'project', scopeId: projectId },
+                stackId,
+            });
+            if (stackResponse.ok) {
+                if (v)
+                    log(`Deployment "Stack" ${niceId(stackId)} ready`);
+                diagnostics.stackReady = true;
+                diagnostics.userHasAccess = true;
+            }
+            else if (stackResponse.response?.status === 404) {
+                if (v)
+                    yikes(`Deployment "Stack" <${stackId}> not found`);
+                diagnostics.stackReady = false;
+            }
+            else if (stackResponse.response?.status === 403 || stackResponse.response?.status === 401) {
+                if (v)
+                    yikes(`User does not have access to "Stack" <${stackId}>`);
+                diagnostics.userHasAccess = false;
+            }
+            else {
+                if (v)
+                    yikes(`Unknown error with "Stack" <${stackId}>: ${stackResponse.error}`);
+            }
+        }
+        else {
+            if (v)
+                yikes('Unable to check deployment "Stack" status.');
+        }
+    }
+    if (spinner)
+        spinner.stop();
+    if (v)
+        log('');
+    let allGood = true;
+    for (const [key, value] of Object.entries(diagnostics)) {
+        switch (value) {
+            case true:
+                if (v)
+                    log(check(diagLookup[key]));
+                break;
+            case false:
+                allGood = false;
+                log(severe(diagLookup[key]));
+                break;
+            case null:
+                allGood = false;
+                log(warn(diagLookup[key]));
+                break;
+            default:
+                allGood = false;
+                log(severe(`${key} is ${value}`));
+        }
+    }
+    if (allGood) {
+        log(chalk.bold.green('All checks passed'));
+        return { success: true, data: { diagnostics } };
+    }
+    else {
+        return { success: false, error: 'One or more checks failed', data: { diagnostics } };
+    }
+}