workspace-architect 2.2.1 → 2.2.3

package/assets-manifest.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-01-16T01:10:43.866Z",
+  "generatedAt": "2026-01-22T00:32:32.273Z",
   "assets": {
     "agents": {
       "4.1-Beast": {
@@ -159,6 +159,24 @@
         "title": "blueprint-mode",
         "type": "agents"
       },
+      "cast-imaging-impact-analysis": {
+        "path": "assets/agents/cast-imaging-impact-analysis.agent.md",
+        "description": "Specialized agent for comprehensive change impact assessment and risk analysis in software systems using CAST Imaging",
+        "title": "cast-imaging-impact-analysis",
+        "type": "agents"
+      },
+      "cast-imaging-software-discovery": {
+        "path": "assets/agents/cast-imaging-software-discovery.agent.md",
+        "description": "Specialized agent for comprehensive software application discovery and architectural mapping through static code analysis using CAST Imaging",
+        "title": "cast-imaging-software-discovery",
+        "type": "agents"
+      },
+      "cast-imaging-structural-quality-advisor": {
+        "path": "assets/agents/cast-imaging-structural-quality-advisor.agent.md",
+        "description": "Specialized agent for identifying, analyzing, and providing remediation guidance for code quality issues using CAST Imaging",
+        "title": "cast-imaging-structural-quality-advisor",
+        "type": "agents"
+      },
       "clojure-interactive-programming": {
         "path": "assets/agents/clojure-interactive-programming.agent.md",
         "description": "Expert Clojure pair programmer with REPL-first methodology, architectural oversight, and interactive problem-solving. Enforces quality standards, prevents workarounds, and develops solutions incrementally through live REPL evaluation before file modifications.",
@@ -483,6 +501,12 @@
         "title": "octopus-deploy-release-notes-mcp",
         "type": "agents"
       },
+      "openapi-to-application": {
+        "path": "assets/agents/openapi-to-application.agent.md",
+        "description": "Expert assistant for generating working applications from OpenAPI specifications",
+        "title": "openapi-to-application",
+        "type": "agents"
+      },
       "pagerduty-incident-responder": {
         "path": "assets/agents/pagerduty-incident-responder.agent.md",
         "description": "Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs.",
@@ -1789,6 +1813,12 @@
         "title": "ai-prompt-engineering-safety-review",
         "type": "prompts"
       },
+      "apple-appstore-reviewer": {
+        "path": "assets/prompts/apple-appstore-reviewer.prompt.md",
+        "description": "Serves as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.",
+        "title": "apple-appstore-reviewer",
+        "type": "prompts"
+      },
       "architecture-blueprint-generator": {
         "path": "assets/prompts/architecture-blueprint-generator.prompt.md",
         "description": "Comprehensive project architecture blueprint generator that analyzes codebases to create detailed architectural documentation. Automatically detects technology stacks and architectural patterns, generates visual diagrams, documents implementation patterns, and provides extensible blueprints for maintaining architectural consistency and guiding new development.",
@@ -2287,6 +2317,12 @@
         "title": "next-intl-add-language",
         "type": "prompts"
       },
+      "openapi-to-application-code": {
+        "path": "assets/prompts/openapi-to-application-code.prompt.md",
+        "description": "Generate a complete, production-ready application from an OpenAPI specification",
+        "title": "openapi-to-application-code",
+        "type": "prompts"
+      },
       "php-mcp-server-generator": {
         "path": "assets/prompts/php-mcp-server-generator.prompt.md",
         "description": "Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK",
@@ -2890,6 +2926,17 @@
           "prompts:az-cost-optimize"
         ]
       },
+      "cast-imaging": {
+        "path": "assets/collections/cast-imaging.collection.yml",
+        "description": "A comprehensive collection of specialized agents for software analysis, impact assessment, structural quality advisories, and architectural review using CAST Imaging.",
+        "title": "CAST Imaging Agents",
+        "type": "collections",
+        "items": [
+          "agents:cast-imaging-software-discovery",
+          "agents:cast-imaging-impact-analysis",
+          "agents:cast-imaging-structural-quality-advisor"
+        ]
+      },
       "claude-skills-starter": {
         "path": "assets/collections/claude-skills-starter.json",
         "description": "Essential Claude Skills for software development, planning, and automation workflows.",
@@ -3560,6 +3607,61 @@
           "prompts:technology-stack-blueprint-generator"
         ]
       },
+      "openapi-to-application-csharp-dotnet": {
+        "path": "assets/collections/openapi-to-application-csharp-dotnet.collection.yml",
+        "description": "Generate production-ready .NET applications from OpenAPI specifications. Includes ASP.NET Core project scaffolding, controller generation, entity framework integration, and C# best practices.",
+        "title": "OpenAPI to Application - C# .NET",
+        "type": "collections",
+        "items": [
+          "agents:openapi-to-application",
+          "instructions:csharp",
+          "prompts:openapi-to-application-code"
+        ]
+      },
+      "openapi-to-application-go": {
+        "path": "assets/collections/openapi-to-application-go.collection.yml",
+        "description": "Generate production-ready Go applications from OpenAPI specifications. Includes project scaffolding, handler generation, middleware setup, and Go best practices for REST APIs.",
+        "title": "OpenAPI to Application - Go",
+        "type": "collections",
+        "items": [
+          "agents:openapi-to-application",
+          "instructions:go",
+          "prompts:openapi-to-application-code"
+        ]
+      },
+      "openapi-to-application-java-spring-boot": {
+        "path": "assets/collections/openapi-to-application-java-spring-boot.collection.yml",
+        "description": "Generate production-ready Spring Boot applications from OpenAPI specifications. Includes project scaffolding, REST controller generation, service layer organization, and Spring Boot best practices.",
+        "title": "OpenAPI to Application - Java Spring Boot",
+        "type": "collections",
+        "items": [
+          "agents:openapi-to-application",
+          "instructions:springboot",
+          "prompts:openapi-to-application-code"
+        ]
+      },
+      "openapi-to-application-nodejs-nestjs": {
+        "path": "assets/collections/openapi-to-application-nodejs-nestjs.collection.yml",
+        "description": "Generate production-ready NestJS applications from OpenAPI specifications. Includes project scaffolding, controller and service generation, TypeScript best practices, and enterprise patterns.",
+        "title": "OpenAPI to Application - Node.js NestJS",
+        "type": "collections",
+        "items": [
+          "agents:openapi-to-application",
+          "instructions:nestjs",
+          "prompts:openapi-to-application-code"
+        ]
+      },
+      "openapi-to-application-python-fastapi": {
+        "path": "assets/collections/openapi-to-application-python-fastapi.collection.yml",
+        "description": "Generate production-ready FastAPI applications from OpenAPI specifications. Includes project scaffolding, route generation, dependency injection, and Python best practices for async APIs.",
+        "title": "OpenAPI to Application - Python FastAPI",
+        "type": "collections",
+        "items": [
+          "agents:openapi-to-application",
+          "instructions:python",
+          "prompts:openapi-to-application-code"
+        ]
+      },
       "partners": {
         "path": "assets/collections/partners.collection.yml",
         "description": "Custom agents that have been created by GitHub partners",

package/bin/cli-functions.js

@@ -0,0 +1,490 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.join(__dirname, '..');
+const ASSETS_DIR = path.join(ROOT_DIR, 'assets');
+const MANIFEST_PATH = path.join(ROOT_DIR, 'assets-manifest.json');
+
+// Check if running in local development mode (assets folder exists)
+// Made async function to avoid top-level await issues in tests
+let _isLocalCache = null;
+export async function isLocal() {
+  if (_isLocalCache === null) {
+    _isLocalCache = await fs.pathExists(ASSETS_DIR);
+  }
+  return _isLocalCache;
+}
+
+// For backward compatibility
+export const IS_LOCAL = await fs.pathExists(ASSETS_DIR);
+
+/**
+ * Normalize collection items to flat array format for processing.
+ * Supports both old flat array format and new nested object format.
+ * 
+ * Old format: ["instructions:reactjs", "prompts:code-review"]
+ * New format: { "instructions": ["reactjs"], "prompts": ["code-review"] }
+ * 
+ * @param {Array|Object} items - Collection items in either format
+ * @returns {Array} Flat array of items in "type:name" format
+ */
+export function normalizeCollectionItems(items) {
+  if (!items) return [];
+  
+  // If it's already an array (old format), return as-is
+  if (Array.isArray(items)) {
+    return items;
+  }
+  
+  // If it's an object (new format), convert to flat array
+  if (typeof items === 'object') {
+    const flatItems = [];
+    for (const [type, names] of Object.entries(items)) {
+      if (Array.isArray(names)) {
+        for (const name of names) {
+          flatItems.push(`${type}:${name}`);
+        }
+      }
+    }
+    return flatItems;
+  }
+  
+  return [];
+}
+
+/**
+ * Convert YAML collection items format to flat array format.
+ * YAML format: [{ path: "agents/foo.agent.md", kind: "agent" }, ...]
+ * Flat format: ["agents:foo", ...]
+ * 
+ * @param {Array} items - YAML collection items
+ * @returns {Array} Flat array of items in "type:name" format
+ */
+export function convertYamlItemsToFlat(items) {
+  if (!Array.isArray(items)) return [];
+  
+  // Mapping of singular to plural forms for asset types
+  const pluralMap = {
+    'agent': 'agents',
+    'instruction': 'instructions',
+    'prompt': 'prompts',
+    'skill': 'skills',
+    'collection': 'collections'
+  };
+  
+  const flatItems = [];
+  for (const item of items) {
+    if (!item.path || !item.kind) continue;
+    
+    // Extract the type and name from the path
+    // Path format: "agents/foo.agent.md" or "instructions/bar.instructions.md"
+    const pathParts = item.path.split('/');
+    if (pathParts.length < 2) continue;
+    
+    const fileName = pathParts[pathParts.length - 1];
+    const type = pluralMap[item.kind] || item.kind + 's'; // Use mapping or fallback to simple pluralization
+    
+    // Extract name by removing extension
+    let name = fileName
+      .replace('.agent.md', '')
+      .replace('.instructions.md', '')
+      .replace('.prompt.md', '')
+      .replace('.md', '');
+    
+    flatItems.push(`${type}:${name}`);
+  }
+  
+  return flatItems;
+}
+
+export async function getManifest() {
+  if (await fs.pathExists(MANIFEST_PATH)) {
+    return fs.readJson(MANIFEST_PATH);
+  }
+  throw new Error('Manifest file not found. Please report this issue.');
+}
+
+export async function listAssets(type) {
+  if (IS_LOCAL) {
+    // Local Development Mode
+    const matter = (await import('gray-matter')).default;
+    const YAML = (await import('yaml')).default;
+    // All types use assets/<type> directory
+    const dirPath = path.join(ASSETS_DIR, type);
+    
+    if (!await fs.pathExists(dirPath)) {
+      console.log(chalk.yellow(`No assets found for type: ${type}`));
+      return;
+    }
+
+    const files = await fs.readdir(dirPath);
+    if (files.length === 0) {
+      console.log(chalk.yellow(`No assets found for type: ${type}`));
+      return;
+    }
+
+    console.log(chalk.blue.bold(`\nAvailable ${type}:`));
+    for (const file of files) {
+      // Skip .upstream-sync.json files
+      if (file === '.upstream-sync.json') continue;
+      
+      const filePath = path.join(dirPath, file);
+      const stat = await fs.stat(filePath);
+      let description = '';
+
+      try {
+        if (type === 'skills' && stat.isDirectory()) {
+          // For Skills, read SKILL.md from directory
+          const skillMdPath = path.join(filePath, 'SKILL.md');
+          if (await fs.pathExists(skillMdPath)) {
+            const content = await fs.readFile(skillMdPath, 'utf8');
+            const parsed = matter(content);
+            description = parsed.data.description || '';
+          }
+        } else if (type === 'collections') {
+          if (file.endsWith('.json')) {
+            const content = await fs.readJson(filePath);
+            description = content.description || '';
+          } else if (file.endsWith('.yml') || file.endsWith('.yaml')) {
+            const content = await fs.readFile(filePath, 'utf8');
+            const parsed = YAML.parse(content);
+            description = parsed.description || '';
+          }
+        } else if (!stat.isDirectory()) {
+          const content = await fs.readFile(filePath, 'utf8');
+          const parsed = matter(content);
+          description = parsed.data.description || '';
+        }
+      } catch (_error) {
+        // Ignore errors reading metadata
+      }
+
+      // Extract clean name without extensions
+      let name;
+      if (type === 'skills' && stat.isDirectory()) {
+        name = file;
+      } else if (type === 'collections') {
+        name = file.replace(/\.(collection\.)?(yml|yaml|json)$/, '');
+      } else if (type === 'instructions') {
+        name = file.replace('.instructions.md', '');
+      } else if (type === 'prompts') {
+        name = file.replace('.prompt.md', '');
+      } else if (type === 'agents') {
+        name = file.replace('.agent.md', '');
+      } else {
+        name = path.parse(file).name;
+      }
+      
+      console.log(`  - ${name}${description ? ` - ${description}` : ''}`);
+    }
+  } else {
+    // Production Mode (Manifest)
+    const manifest = await getManifest();
+    const typeAssets = manifest.assets[type] || {};
+    const assets = Object.entries(typeAssets)
+      .map(([id, asset]) => ({
+        id,
+        ...asset
+      }));
+    
+    if (assets.length === 0) {
+      console.log(chalk.yellow(`No assets found for type: ${type}`));
+      return;
+    }
+
+    console.log(chalk.blue.bold(`\nAvailable ${type}:`));
+    for (const asset of assets) {
+      const versionInfo = asset.metadata?.version ? ` (v${asset.metadata.version})` : '';
+      console.log(`  - ${asset.id}${versionInfo}${asset.description ? ` - ${asset.description}` : ''}`);
+    }
+  }
+}
+
+export async function downloadSkill(name, options) {
+  const skillName = name;
+  let skillFiles = [];
+  let skillPath = '';
+
+  if (IS_LOCAL) {
+    // Local mode: copy from assets/skills
+    skillPath = path.join(ASSETS_DIR, 'skills', skillName);
+    
+    if (!await fs.pathExists(skillPath)) {
+      throw new Error(`Skill not found: skills/${skillName}`);
+    }
+    
+    // Get all files in the skill directory
+    const getAllFiles = async (dir, baseDir = dir) => {
+      const files = [];
+      const entries = await fs.readdir(dir, { withFileTypes: true });
+      
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          const subFiles = await getAllFiles(fullPath, baseDir);
+          files.push(...subFiles);
+        } else {
+          const relativePath = path.relative(baseDir, fullPath);
+          files.push({ relative: relativePath, full: fullPath });
+        }
+      }
+      return files;
+    };
+    
+    skillFiles = await getAllFiles(skillPath);
+  } else {
+    // Production mode: fetch from manifest and download from GitHub
+    const manifest = await getManifest();
+    const asset = manifest.assets.skills?.[skillName];
+    
+    if (!asset) {
+      throw new Error(`Skill not found: ${skillName}`);
+    }
+    
+    skillPath = asset.path;
+    skillFiles = asset.files.map(file => ({
+      relative: file,
+      url: `https://raw.githubusercontent.com/archubbuck/workspace-architect/main/${asset.path}/${file}`
+    }));
+  }
+
+  // Determine destination
+  let destDir;
+  if (options.output) {
+    destDir = path.resolve(process.cwd(), options.output);
+  } else {
+    destDir = path.join(process.cwd(), '.github', 'skills', skillName);
+  }
+
+  if (options.dryRun) {
+    console.log(chalk.cyan(`[Dry Run] Would create skill directory at ${destDir}`));
+    for (const file of skillFiles) {
+      console.log(chalk.cyan(`  Would copy: ${file.relative}`));
+    }
+    return;
+  }
+
+  // Check if skill already exists
+  if (await fs.pathExists(destDir) && !options.force) {
+    const inquirer = (await import('inquirer')).default;
+    const { overwrite } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'overwrite',
+        message: `Skill ${skillName} already exists in ${destDir}. Overwrite?`,
+        default: false
+      }
+    ]);
+
+    if (!overwrite) {
+      console.log(chalk.yellow('Operation cancelled.'));
+      return;
+    }
+  }
+
+  console.log(chalk.blue(`Downloading skill: ${skillName}`));
+  
+  // Create skill directory
+  await fs.ensureDir(destDir);
+
+  // Download/copy all files
+  for (const file of skillFiles) {
+    const destPath = path.join(destDir, file.relative);
+    const destFileDir = path.dirname(destPath);
+    await fs.ensureDir(destFileDir);
+
+    if (IS_LOCAL) {
+      // Copy from local assets
+      await fs.copyFile(file.full, destPath);
+    } else {
+      // Download from GitHub
+      const response = await fetch(file.url);
+      if (!response.ok) {
+        console.warn(chalk.yellow(`Warning: Failed to download ${file.relative}`));
+        continue;
+      }
+      const content = await response.text();
+      await fs.writeFile(destPath, content);
+    }
+    
+    console.log(chalk.dim(`  Downloaded: ${file.relative}`));
+  }
+
+  console.log(chalk.green(`Successfully downloaded skill ${skillName} to ${destDir} (${skillFiles.length} files)`));
+}
+
+export async function downloadAsset(id, options) {
+  const [type, name] = id.split(':');
+
+  if (!type || !name) {
+    throw new Error('Invalid ID format. Use type:name (e.g., instructions:basic-setup)');
+  }
+
+  const validTypes = ['instructions', 'prompts', 'agents', 'skills', 'collections'];
+  if (!validTypes.includes(type)) {
+    throw new Error(`Invalid type: ${type}. Valid types are: ${validTypes.join(', ')}`);
+  }
+
+  // Handle Collections
+  if (type === 'collections') {
+    let items = [];
+    
+    if (IS_LOCAL) {
+      const YAML = (await import('yaml')).default;
+      
+      // Try to find the collection file with various extensions
+      const possibleFileNames = [
+        `${name}.json`,
+        `${name}.collection.yml`,
+        `${name}.collection.yaml`,
+        `${name}.yml`,
+        `${name}.yaml`
+      ];
+      
+      let sourcePath = null;
+      let isYaml = false;
+      
+      for (const fileName of possibleFileNames) {
+        const testPath = path.join(ASSETS_DIR, 'collections', fileName);
+        if (await fs.pathExists(testPath)) {
+          sourcePath = testPath;
+          isYaml = fileName.endsWith('.yml') || fileName.endsWith('.yaml');
+          break;
+        }
+      }
+      
+      if (!sourcePath) {
+        throw new Error(`Collection not found: ${type}/${name}`);
+      }
+      
+      if (isYaml) {
+        const content = await fs.readFile(sourcePath, 'utf8');
+        const parsed = YAML.parse(content);
+        // Convert YAML format items to flat array
+        items = convertYamlItemsToFlat(parsed.items || []);
+      } else {
+        const collectionContent = await fs.readJson(sourcePath);
+        const rawItems = collectionContent.items || (Array.isArray(collectionContent) ? collectionContent : []);
+        items = normalizeCollectionItems(rawItems);
+      }
+    } else {
+      const manifest = await getManifest();
+      const asset = manifest.assets[type]?.[name];
+      
+      if (!asset) {
+        throw new Error(`Collection not found: ${id}`);
+      }
+      
+      items = normalizeCollectionItems(asset.items || []);
+    }
+
+    console.log(chalk.blue(`Downloading collection: ${name}`));
+    for (const assetId of items) {
+      try {
+        await downloadAsset(assetId, options);
+      } catch (error) {
+        console.error(chalk.red(`Failed to download ${assetId} from collection:`), error.message);
+      }
+    }
+    return;
+  }
+
+  // Handle Skills (multi-file folder-based assets)
+  if (type === 'skills') {
+    await downloadSkill(name, options);
+    return;
+  }
+
+  // Handle Single Asset
+  let content = '';
+  let fileName = '';
+
+  if (IS_LOCAL) {
+    // Try to find the file with various extensions
+    const potentialFileNames = [
+      name,
+      name + '.md'
+    ];
+    if (type === 'agents') potentialFileNames.push(name + '.agent.md');
+    if (type === 'prompts') potentialFileNames.push(name + '.prompt.md');
+    if (type === 'instructions') potentialFileNames.push(name + '.instructions.md');
+
+    // All types use assets/<type> directory
+    const baseDir = path.join(ASSETS_DIR, type);
+    
+    let sourcePath = null;
+    for (const fname of potentialFileNames) {
+      const p = path.join(baseDir, fname);
+      if (await fs.pathExists(p)) {
+        sourcePath = p;
+        fileName = fname;
+        break;
+      }
+    }
+
+    if (!sourcePath) {
+      throw new Error(`Asset not found: ${type}/${name}`);
+    }
+    
+    content = await fs.readFile(sourcePath, 'utf8');
+  } else {
+    const manifest = await getManifest();
+    const asset = manifest.assets[type]?.[name];
+    
+    if (!asset) {
+      throw new Error(`Asset not found: ${id}`);
+    }
+    
+    fileName = path.basename(asset.path);
+    const url = `https://raw.githubusercontent.com/archubbuck/workspace-architect/main/${asset.path}`;
+    
+    console.log(chalk.dim(`Fetching ${url}...`));
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
+    }
+    content = await response.text();
+  }
+
+  // Determine Destination
+  let destDir;
+  if (options.output) {
+    destDir = path.resolve(process.cwd(), options.output);
+  } else {
+    destDir = path.join(process.cwd(), '.github', type);
+  }
+
+  const destPath = path.join(destDir, fileName);
+
+  if (options.dryRun) {
+    console.log(chalk.cyan(`[Dry Run] Would write to ${destPath}`));
+    return;
+  }
+
+  // Ensure destination directory exists
+  await fs.ensureDir(destDir);
+
+  if (await fs.pathExists(destPath) && !options.force) {
+    const inquirer = (await import('inquirer')).default;
+    const { overwrite } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'overwrite',
+        message: `File ${fileName} already exists in ${destDir}. Overwrite?`,
+        default: false
+      }
+    ]);
+
+    if (!overwrite) {
+      console.log(chalk.yellow('Operation cancelled.'));
+      return;
+    }
+  }
+
+  await fs.writeFile(destPath, content);
+  console.log(chalk.green(`Successfully downloaded ${fileName} to ${destDir}`));
+}

package/bin/cli.js

@@ -1,99 +1,11 @@
 #!/usr/bin/env node
 
 import { program } from 'commander';
-import inquirer from 'inquirer';
-import fs from 'fs-extra';
-import path from 'path';
 import chalk from 'chalk';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const ROOT_DIR = path.join(__dirname, '..');
-const ASSETS_DIR = path.join(ROOT_DIR, 'assets');
-const MANIFEST_PATH = path.join(ROOT_DIR, 'assets-manifest.json');
-
-// Check if running in local development mode (assets folder exists)
-const IS_LOCAL = await fs.pathExists(ASSETS_DIR);
-
-/**
- * Normalize collection items to flat array format for processing.
- * Supports both old flat array format and new nested object format.
- * 
- * Old format: ["instructions:reactjs", "prompts:code-review"]
- * New format: { "instructions": ["reactjs"], "prompts": ["code-review"] }
- * 
- * @param {Array|Object} items - Collection items in either format
- * @returns {Array} Flat array of items in "type:name" format
- */
-function normalizeCollectionItems(items) {
-  if (!items) return [];
-  
-  // If it's already an array (old format), return as-is
-  if (Array.isArray(items)) {
-    return items;
-  }
-  
-  // If it's an object (new format), convert to flat array
-  if (typeof items === 'object') {
-    const flatItems = [];
-    for (const [type, names] of Object.entries(items)) {
-      if (Array.isArray(names)) {
-        for (const name of names) {
-          flatItems.push(`${type}:${name}`);
-        }
-      }
-    }
-    return flatItems;
-  }
-  
-  return [];
-}
-
-/**
- * Convert YAML collection items format to flat array format.
- * YAML format: [{ path: "agents/foo.agent.md", kind: "agent" }, ...]
- * Flat format: ["agents:foo", ...]
- * 
- * @param {Array} items - YAML collection items
- * @returns {Array} Flat array of items in "type:name" format
- */
-function convertYamlItemsToFlat(items) {
-  if (!Array.isArray(items)) return [];
-  
-  // Mapping of singular to plural forms for asset types
-  const pluralMap = {
-    'agent': 'agents',
-    'instruction': 'instructions',
-    'prompt': 'prompts',
-    'skill': 'skills',
-    'collection': 'collections'
-  };
-  
-  const flatItems = [];
-  for (const item of items) {
-    if (!item.path || !item.kind) continue;
-    
-    // Extract the type and name from the path
-    // Path format: "agents/foo.agent.md" or "instructions/bar.instructions.md"
-    const pathParts = item.path.split('/');
-    if (pathParts.length < 2) continue;
-    
-    const fileName = pathParts[pathParts.length - 1];
-    const type = pluralMap[item.kind] || item.kind + 's'; // Use mapping or fallback to simple pluralization
-    
-    // Extract name by removing extension
-    let name = fileName
-      .replace('.agent.md', '')
-      .replace('.instructions.md', '')
-      .replace('.prompt.md', '')
-      .replace('.md', '');
-    
-    flatItems.push(`${type}:${name}`);
-  }
-  
-  return flatItems;
-}
+import {
+  listAssets,
+  downloadAsset,
+} from './cli-functions.js';
 
 program
   .name('workspace-architect')
@@ -153,390 +65,4 @@ program
     }
   });
 
-async function getManifest() {
-  if (await fs.pathExists(MANIFEST_PATH)) {
-    return fs.readJson(MANIFEST_PATH);
-  }
-  throw new Error('Manifest file not found. Please report this issue.');
-}
-
-async function listAssets(type) {
-  if (IS_LOCAL) {
-    // Local Development Mode
-    const matter = (await import('gray-matter')).default;
-    const YAML = (await import('yaml')).default;
-    // All types use assets/<type> directory
-    const dirPath = path.join(ASSETS_DIR, type);
-    
-    if (!await fs.pathExists(dirPath)) {
-      console.log(chalk.yellow(`No assets found for type: ${type}`));
-      return;
-    }
-
-    const files = await fs.readdir(dirPath);
-    if (files.length === 0) {
-      console.log(chalk.yellow(`No assets found for type: ${type}`));
-      return;
-    }
-
-    console.log(chalk.blue.bold(`\nAvailable ${type}:`));
-    for (const file of files) {
-      // Skip .upstream-sync.json files
-      if (file === '.upstream-sync.json') continue;
-      
-      const filePath = path.join(dirPath, file);
-      const stat = await fs.stat(filePath);
-      let description = '';
-
-      try {
-        if (type === 'skills' && stat.isDirectory()) {
-          // For Skills, read SKILL.md from directory
-          const skillMdPath = path.join(filePath, 'SKILL.md');
-          if (await fs.pathExists(skillMdPath)) {
-            const content = await fs.readFile(skillMdPath, 'utf8');
-            const parsed = matter(content);
-            description = parsed.data.description || '';
-          }
-        } else if (type === 'collections') {
-          if (file.endsWith('.json')) {
-            const content = await fs.readJson(filePath);
-            description = content.description || '';
-          } else if (file.endsWith('.yml') || file.endsWith('.yaml')) {
-            const content = await fs.readFile(filePath, 'utf8');
-            const parsed = YAML.parse(content);
-            description = parsed.description || '';
-          }
-        } else if (!stat.isDirectory()) {
-          const content = await fs.readFile(filePath, 'utf8');
-          const parsed = matter(content);
-          description = parsed.data.description || '';
-        }
-      } catch (e) {
-        // Ignore errors reading metadata
-      }
-
-      // Extract clean name without extensions
-      let name;
-      if (type === 'skills' && stat.isDirectory()) {
-        name = file;
-      } else if (type === 'collections') {
-        name = file.replace(/\.(collection\.)?(yml|yaml|json)$/, '');
-      } else if (type === 'instructions') {
-        name = file.replace('.instructions.md', '');
-      } else if (type === 'prompts') {
-        name = file.replace('.prompt.md', '');
-      } else if (type === 'agents') {
-        name = file.replace('.agent.md', '');
-      } else {
-        name = path.parse(file).name;
-      }
-      
-      console.log(`  - ${name}${description ? ` - ${description}` : ''}`);
-    }
-  } else {
-    // Production Mode (Manifest)
-    const manifest = await getManifest();
-    const typeAssets = manifest.assets[type] || {};
-    const assets = Object.entries(typeAssets)
-      .map(([id, asset]) => ({
-        id,
-        ...asset
-      }));
-    
-    if (assets.length === 0) {
-      console.log(chalk.yellow(`No assets found for type: ${type}`));
-      return;
-    }
-
-    console.log(chalk.blue.bold(`\nAvailable ${type}:`));
-    for (const asset of assets) {
-      const versionInfo = asset.metadata?.version ? ` (v${asset.metadata.version})` : '';
-      console.log(`  - ${asset.id}${versionInfo}${asset.description ? ` - ${asset.description}` : ''}`);
-    }
-  }
-}
-
-async function downloadAsset(id, options) {
-  const [type, name] = id.split(':');
-
-  if (!type || !name) {
-    throw new Error('Invalid ID format. Use type:name (e.g., instructions:basic-setup)');
-  }
-
-  const validTypes = ['instructions', 'prompts', 'agents', 'skills', 'collections'];
-  if (!validTypes.includes(type)) {
-    throw new Error(`Invalid type: ${type}. Valid types are: ${validTypes.join(', ')}`);
-  }
-
-  // Handle Collections
-  if (type === 'collections') {
-    let items = [];
-    
-    if (IS_LOCAL) {
-      const YAML = (await import('yaml')).default;
-      
-      // Try to find the collection file with various extensions
-      const possibleFileNames = [
-        `${name}.json`,
-        `${name}.collection.yml`,
-        `${name}.collection.yaml`,
-        `${name}.yml`,
-        `${name}.yaml`
-      ];
-      
-      let sourcePath = null;
-      let isYaml = false;
-      
-      for (const fileName of possibleFileNames) {
-        const testPath = path.join(ASSETS_DIR, 'collections', fileName);
-        if (await fs.pathExists(testPath)) {
-          sourcePath = testPath;
-          isYaml = fileName.endsWith('.yml') || fileName.endsWith('.yaml');
-          break;
-        }
-      }
-      
-      if (!sourcePath) {
-        throw new Error(`Collection not found: ${type}/${name}`);
-      }
-      
-      if (isYaml) {
-        const content = await fs.readFile(sourcePath, 'utf8');
-        const parsed = YAML.parse(content);
-        // Convert YAML format items to flat array
-        items = convertYamlItemsToFlat(parsed.items || []);
-      } else {
-        const collectionContent = await fs.readJson(sourcePath);
-        const rawItems = collectionContent.items || (Array.isArray(collectionContent) ? collectionContent : []);
-        items = normalizeCollectionItems(rawItems);
-      }
-    } else {
-      const manifest = await getManifest();
-      const asset = manifest.assets[type]?.[name];
-      
-      if (!asset) {
-        throw new Error(`Collection not found: ${id}`);
-      }
-      
-      items = normalizeCollectionItems(asset.items || []);
-    }
-
-    console.log(chalk.blue(`Downloading collection: ${name}`));
-    for (const assetId of items) {
-      try {
-        await downloadAsset(assetId, options);
-      } catch (error) {
-        console.error(chalk.red(`Failed to download ${assetId} from collection:`), error.message);
-      }
-    }
-    return;
-  }
-
-  // Handle Skills (multi-file folder-based assets)
-  if (type === 'skills') {
-    await downloadSkill(name, options);
-    return;
-  }
-
-  // Handle Single Asset
-  let content = '';
-  let fileName = '';
-
-  if (IS_LOCAL) {
-    // Try to find the file with various extensions
-    const potentialFileNames = [
-      name,
-      name + '.md'
-    ];
-    if (type === 'agents') potentialFileNames.push(name + '.agent.md');
-    if (type === 'prompts') potentialFileNames.push(name + '.prompt.md');
-    if (type === 'instructions') potentialFileNames.push(name + '.instructions.md');
-
-    // All types use assets/<type> directory
-    const baseDir = path.join(ASSETS_DIR, type);
-    
-    let sourcePath = null;
-    for (const fname of potentialFileNames) {
-      const p = path.join(baseDir, fname);
-      if (await fs.pathExists(p)) {
-        sourcePath = p;
-        fileName = fname;
-        break;
-      }
-    }
-
-    if (!sourcePath) {
-      throw new Error(`Asset not found: ${type}/${name}`);
-    }
-    
-    content = await fs.readFile(sourcePath, 'utf8');
-  } else {
-    const manifest = await getManifest();
-    const asset = manifest.assets[type]?.[name];
-    
-    if (!asset) {
-      throw new Error(`Asset not found: ${id}`);
-    }
-    
-    fileName = path.basename(asset.path);
-    const url = `https://raw.githubusercontent.com/archubbuck/workspace-architect/main/${asset.path}`;
-    
-    console.log(chalk.dim(`Fetching ${url}...`));
-    const response = await fetch(url);
-    if (!response.ok) {
-      throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
-    }
-    content = await response.text();
-  }
-
-  // Determine Destination
-  let destDir;
-  if (options.output) {
-    destDir = path.resolve(process.cwd(), options.output);
-  } else {
-    destDir = path.join(process.cwd(), '.github', type);
-  }
-
-  const destPath = path.join(destDir, fileName);
-
-  if (options.dryRun) {
-    console.log(chalk.cyan(`[Dry Run] Would write to ${destPath}`));
-    return;
-  }
-
-  // Ensure destination directory exists
-  await fs.ensureDir(destDir);
-
-  if (await fs.pathExists(destPath) && !options.force) {
-    const { overwrite } = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'overwrite',
-        message: `File ${fileName} already exists in ${destDir}. Overwrite?`,
-        default: false
-      }
-    ]);
-
-    if (!overwrite) {
-      console.log(chalk.yellow('Operation cancelled.'));
-      return;
-    }
-  }
-
-  await fs.writeFile(destPath, content);
-  console.log(chalk.green(`Successfully downloaded ${fileName} to ${destDir}`));
-}
-
-async function downloadSkill(name, options) {
-  const skillName = name;
-  let skillFiles = [];
-  let skillPath = '';
-
-  if (IS_LOCAL) {
-    // Local mode: copy from assets/skills
-    skillPath = path.join(ASSETS_DIR, 'skills', skillName);
-    
-    if (!await fs.pathExists(skillPath)) {
-      throw new Error(`Skill not found: skills/${skillName}`);
-    }
-    
-    // Get all files in the skill directory
-    const getAllFiles = async (dir, baseDir = dir) => {
-      const files = [];
-      const entries = await fs.readdir(dir, { withFileTypes: true });
-      
-      for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-          const subFiles = await getAllFiles(fullPath, baseDir);
-          files.push(...subFiles);
-        } else {
-          const relativePath = path.relative(baseDir, fullPath);
-          files.push({ relative: relativePath, full: fullPath });
-        }
-      }
-      return files;
-    };
-    
-    skillFiles = await getAllFiles(skillPath);
-  } else {
-    // Production mode: fetch from manifest and download from GitHub
-    const manifest = await getManifest();
-    const asset = manifest.assets.skills?.[skillName];
-    
-    if (!asset) {
-      throw new Error(`Skill not found: ${skillName}`);
-    }
-    
-    skillPath = asset.path;
-    skillFiles = asset.files.map(file => ({
-      relative: file,
-      url: `https://raw.githubusercontent.com/archubbuck/workspace-architect/main/${asset.path}/${file}`
-    }));
-  }
-
-  // Determine destination
-  let destDir;
-  if (options.output) {
-    destDir = path.resolve(process.cwd(), options.output);
-  } else {
-    destDir = path.join(process.cwd(), '.github', 'skills', skillName);
-  }
-
-  if (options.dryRun) {
-    console.log(chalk.cyan(`[Dry Run] Would create skill directory at ${destDir}`));
-    for (const file of skillFiles) {
-      console.log(chalk.cyan(`  Would copy: ${file.relative}`));
-    }
-    return;
-  }
-
-  // Check if skill already exists
-  if (await fs.pathExists(destDir) && !options.force) {
-    const { overwrite } = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'overwrite',
-        message: `Skill ${skillName} already exists in ${destDir}. Overwrite?`,
-        default: false
-      }
-    ]);
-
-    if (!overwrite) {
-      console.log(chalk.yellow('Operation cancelled.'));
-      return;
-    }
-  }
-
-  console.log(chalk.blue(`Downloading skill: ${skillName}`));
-  
-  // Create skill directory
-  await fs.ensureDir(destDir);
-
-  // Download/copy all files
-  for (const file of skillFiles) {
-    const destPath = path.join(destDir, file.relative);
-    const destFileDir = path.dirname(destPath);
-    await fs.ensureDir(destFileDir);
-
-    if (IS_LOCAL) {
-      // Copy from local assets
-      await fs.copyFile(file.full, destPath);
-    } else {
-      // Download from GitHub
-      const response = await fetch(file.url);
-      if (!response.ok) {
-        console.warn(chalk.yellow(`Warning: Failed to download ${file.relative}`));
-        continue;
-      }
-      const content = await response.text();
-      await fs.writeFile(destPath, content);
-    }
-    
-    console.log(chalk.dim(`  Downloaded: ${file.relative}`));
-  }
-
-  console.log(chalk.green(`Successfully downloaded skill ${skillName} to ${destDir} (${skillFiles.length} files)`));
-}
-
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workspace-architect",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "description": "A comprehensive library of specialized AI agents and personas for GitHub Copilot, ranging from architectural planning and specific tech stacks to advanced cognitive reasoning models.",
   "bin": {
     "workspace-architect": "bin/cli.js",
@@ -8,7 +8,12 @@
   },
   "scripts": {
     "start:registry": "verdaccio --config verdaccio/config.yaml",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "test:local": "node bin/cli.js list && node bin/cli.js download instructions a11y --dry-run",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "analyze": "node scripts/analysis/analyze-collections.js",
     "generate-manifest": "node scripts/generation/generate-manifest.js",
     "migrate-collections": "node scripts/generation/migrate-collections-format.js",
@@ -78,10 +83,16 @@
     "yaml": "^2.8.2"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "@release-it/conventional-changelog": "^8.0.2",
+    "@vitest/coverage-v8": "^4.0.17",
     "conventional-changelog-conventionalcommits": "^7.0.2",
+    "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "memfs": "^4.52.0",
     "release-it": "^17.11.0",
-    "verdaccio": "^5.29.0"
+    "verdaccio": "^5.29.0",
+    "vitest": "^4.0.17"
   },
   "type": "module"
 }