feat: Added asdf and aws

kevinwang5658 · kevinwang5658 · commit 78066a9f7de4 · 2026-04-19T22:42:16.000-04:00
diff --git a/src/resources/asdf/asdf-install.ts b/src/resources/asdf/asdf-install.ts
@@ -1,6 +1,7 @@
 import {
   CreatePlan,
   DestroyPlan,
+  ExampleConfig,
   Resource,
   ResourceSettings,
   SpawnStatus,
@@ -30,6 +31,38 @@ const schema = z.object({
   .describe('Install specific version of tools using asdf.');
 
 export type AsdfInstallConfig = z.infer<typeof schema>;
+
+const defaultConfig: Partial<AsdfInstallConfig> = {
+  plugin: '<Replace me here!>',
+  versions: ['latest'],
+}
+
+const examplePluginInstall: ExampleConfig = {
+  title: 'Install specific versions via asdf',
+  description: 'Install one or more specific versions of a language runtime using an asdf plugin.',
+  configs: [{
+    type: 'asdf-install',
+    plugin: 'nodejs',
+    versions: ['22.0.0', 'latest'],
+  }]
+}
+
+const exampleFullInstall: ExampleConfig = {
+  title: 'Full asdf setup — install, plugin, and version',
+  description: 'Install asdf, add the Node.js plugin, and activate a specific version - a complete setup from scratch.',
+  configs: [
+    {
+      type: 'asdf',
+      plugins: ['nodejs'],
+    },
+    {
+      type: 'asdf-install',
+      plugin: 'nodejs',
+      versions: ['22.0.0'],
+    },
+  ]
+}
+
 const CURRENT_VERSION_REGEX = /^([^ ]+?)\s+([^ ]+?)\s+.*/;
 const TOOL_VERSIONS_REGEX = /^([^ ]+) +([^ ]+)$/;
 
@@ -38,6 +71,11 @@ export class AsdfInstallResource extends Resource<AsdfInstallConfig> {
   getSettings(): ResourceSettings<AsdfInstallConfig> {
     return {
       id: 'asdf-install',
+      defaultConfig,
+      exampleConfigs: {
+        example1: examplePluginInstall,
+        example2: exampleFullInstall,
+      },
       operatingSystems: [OS.Darwin, OS.Linux],
       dependencies: ['asdf'],
       schema,
diff --git a/src/resources/asdf/asdf-plugin.ts b/src/resources/asdf/asdf-plugin.ts
@@ -1,6 +1,7 @@
 import {
   CreatePlan,
   DestroyPlan,
+  ExampleConfig,
   Resource,
   ResourceSettings,
   SpawnStatus,
@@ -26,12 +27,51 @@ const schema = z
     .describe('Asdf plugin resource for installing asdf plugins.');
 export type AsdfPluginConfig = z.infer<typeof schema>;
 
+const defaultConfig: Partial<AsdfPluginConfig> = {
+  plugin: '<Replace me here!>',
+}
+
+const exampleNodejs: ExampleConfig = {
+  title: 'Node.js plugin via asdf',
+  description: 'Install the asdf Node.js plugin and pin specific versions for your environment.',
+  configs: [{
+    type: 'asdf-plugin',
+    plugin: 'nodejs',
+    versions: ['22.0.0', 'lts'],
+  }]
+}
+
+const exampleFullInstall: ExampleConfig = {
+  title: 'Full asdf setup — install, plugin, and version',
+  description: 'Install asdf, add the Node.js plugin, and activate a specific version - a complete setup from scratch.',
+  configs: [
+    {
+      type: 'asdf',
+      plugins: ['nodejs'],
+    },
+    {
+      type: 'asdf-plugin',
+      plugin: 'nodejs',
+    },
+    {
+      type: 'asdf-install',
+      plugin: 'nodejs',
+      versions: ['22.0.0'],
+    },
+  ]
+}
+
 const PLUGIN_LIST_REGEX = /^([^ ]+?)\s+([^ ]+)/
 
 export class AsdfPluginResource extends Resource<AsdfPluginConfig> {
   getSettings(): ResourceSettings<AsdfPluginConfig> {
     return {
       id: 'asdf-plugin',
+      defaultConfig,
+      exampleConfigs: {
+        example1: exampleNodejs,
+        example2: exampleFullInstall,
+      },
       operatingSystems: [OS.Darwin, OS.Linux],
       dependencies: ['asdf'],
       schema,
diff --git a/src/resources/asdf/asdf.ts b/src/resources/asdf/asdf.ts
@@ -1,4 +1,4 @@
-import { CreatePlan, FileUtils, Resource, ResourceSettings, SpawnStatus, getPty, z } from '@codifycli/plugin-core';
+import { CreatePlan, ExampleConfig, FileUtils, Resource, ResourceSettings, SpawnStatus, getPty, z } from '@codifycli/plugin-core';
 import { OS } from '@codifycli/schemas';
 import fs from 'node:fs/promises';
 import os from 'node:os';
@@ -19,10 +19,48 @@ const schema = z.object({
 
 export type AsdfConfig = z.infer<typeof schema>
 
+const defaultConfig: Partial<AsdfConfig> = {
+  plugins: [],
+}
+
+const exampleNodePython: ExampleConfig = {
+  title: 'Node.js and Python via asdf',
+  description: 'Install asdf with plugins for Node.js and Python - a common setup for web and scripting work.',
+  configs: [{
+    type: 'asdf',
+    plugins: ['nodejs', 'python'],
+  }]
+}
+
+const exampleFullInstall: ExampleConfig = {
+  title: 'Full asdf setup — install, plugin, and version',
+  description: 'Install asdf, add the Node.js plugin, and activate a specific version - a complete setup from scratch.',
+  configs: [
+    {
+      type: 'asdf',
+      plugins: ['nodejs'],
+    },
+    {
+      type: 'asdf-plugin',
+      plugin: 'nodejs',
+    },
+    {
+      type: 'asdf-install',
+      plugin: 'nodejs',
+      versions: ['22.0.0'],
+    },
+  ]
+}
+
 export class AsdfResource extends Resource<AsdfConfig> {
   getSettings(): ResourceSettings<AsdfConfig> {
     return {
       id: 'asdf',
+      defaultConfig,
+      exampleConfigs: {
+        example1: exampleNodePython,
+        example2: exampleFullInstall,
+      },
       operatingSystems: [OS.Darwin, OS.Linux],
       schema,
       parameterSettings: {
diff --git a/src/resources/aws-cli/cli/aws-cli.ts b/src/resources/aws-cli/cli/aws-cli.ts
@@ -22,7 +22,6 @@ export class AwsCliResource extends Resource<AwsCliConfig> {
     };
   }
 
-
   override async refresh(): Promise<Partial<AwsCliConfig> | null> {
     const $ = getPty();
 
diff --git a/src/resources/aws-cli/profile/aws-profile.ts b/src/resources/aws-cli/profile/aws-profile.ts
@@ -1,6 +1,7 @@
 import {
   CreatePlan,
   DestroyPlan,
+  ExampleConfig,
   ModifyPlan,
   ParameterChange,
   Resource,
@@ -27,11 +28,53 @@ export interface AwsProfileConfig extends StringIndexedObject {
   region: string;
 }
 
+const defaultConfig: Partial<AwsProfileConfig> = {
+  profile: 'default',
+  region: '<Replace me here!>',
+  output: 'json',
+}
+
+const exampleProfile: ExampleConfig = {
+  title: 'AWS named profile',
+  description: 'Configure a named AWS CLI profile with credentials and a default region and output format.',
+  configs: [{
+    type: 'aws-profile',
+    profile: 'default',
+    awsAccessKeyId: '<Replace me here!>',
+    awsSecretAccessKey: '<Replace me here!>',
+    region: 'us-east-1',
+    output: 'json',
+  }]
+}
+
+const exampleWithCli: ExampleConfig = {
+  title: 'Install AWS CLI and configure a profile',
+  description: 'Install the AWS CLI and set up a default profile with credentials — a complete AWS setup from scratch.',
+  configs: [
+    {
+      type: 'aws-cli',
+    },
+    {
+      type: 'aws-profile',
+      profile: 'default',
+      awsAccessKeyId: '<Replace me here!>',
+      awsSecretAccessKey: '<Replace me here!>',
+      region: 'us-east-1',
+      output: 'json',
+    },
+  ]
+}
+
 export class AwsProfileResource extends Resource<AwsProfileConfig> {
 
   getSettings(): ResourceSettings<AwsProfileConfig> {
     return {
       id: 'aws-profile',
+      defaultConfig,
+      exampleConfigs: {
+        example1: exampleProfile,
+        example2: exampleWithCli,
+      },
       operatingSystems: [OS.Darwin, OS.Linux],
       dependencies: ['aws-cli'],
       schema: Schema,

Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,6 @@ export class AwsCliResource extends Resource<AwsCliConfig> {`
`22`	`22`	`};`
`23`	`23`	`}`
`24`	`24`
`25`		`-`
`26`	`25`	`override async refresh(): Promise<Partial<AwsCliConfig> \| null> {`
`27`	`26`	`const $ = getPty();`
`28`	`27`