workspace-architect 2.2.76 → 2.2.78

package/README.md

@@ -87,6 +87,9 @@ npx wsa list
 npx workspace-architect list instructions
 npx wsa list agents
 npx wsa list prompts
+npx wsa list skills
+npx wsa list hooks
+npx wsa list plugins
 npx wsa list collections
 ```
 
@@ -109,6 +112,15 @@ npx wsa download instructions reactjs
 # Download an agent
 npx wsa download agents planner
 
+# Download a skill
+npx wsa download skills example-planner
+
+# Download a hook
+npx wsa download hooks governance-audit
+
+# Download a plugin
+npx wsa download plugins awesome-copilot
+
 # Download a complete collection
 npx wsa download collections devops-essentials
 ```
@@ -121,7 +133,7 @@ npx wsa download collections devops-essentials
 
 ## Asset Types
 
-Workspace Architect provides five types of assets:
+Workspace Architect provides seven types of assets:
 
 | Type | Description | Location |
 |------|-------------|----------|
@@ -129,6 +141,8 @@ Workspace Architect provides five types of assets:
 | **Prompts** | Reusable templates for specific tasks | `.github/prompts/` |
 | **Agents** | Specialized personas defining Copilot behavior | `.github/agents/` |
 | **Skills** | Claude Skills with templates, scripts, and resources | `.github/skills/` |
+| **Hooks** | Event-driven scripts that run during Copilot sessions | `.github/hooks/` |
+| **Plugins** | Bundled collections of agents, skills, and commands | `.github/plugins/` |
 | **Collections** | Bundled assets for specific domains or workflows | Multiple locations |
 
 ### What are Skills?
@@ -153,6 +167,58 @@ npx workspace-architect list skills
 
 For more information, see [Skills User Guide](docs/skills-guide.md) and [Skills vs Agents](docs/skills-vs-agents.md).
 
+### What are Hooks?
+
+**Hooks** are event-driven scripts that execute automatically during GitHub Copilot coding agent sessions. They enable:
+
+- **Session Management**: Run scripts when sessions start or end
+- **Prompt Monitoring**: Execute logic when users submit prompts
+- **Governance & Auditing**: Track and control agent behavior
+- **Custom Workflows**: Integrate with external tools and systems
+
+Hooks are directory-based assets containing:
+- **README.md**: Documentation with metadata (name, description, tags)
+- **hooks.json**: Hook configuration defining event triggers
+- **Shell scripts**: Executable scripts for each hook event
+
+**Example:**
+```bash
+# Download a Hook
+npx workspace-architect download hooks governance-audit
+
+# List all Hooks
+npx workspace-architect list hooks
+```
+
+**Available Hook Events:**
+- `sessionStart` - Triggered when a coding session begins
+- `sessionEnd` - Triggered when a coding session ends
+- `userPromptSubmitted` - Triggered when a user submits a prompt
+
+### What are Plugins?
+
+**Plugins** are bundled packages that extend GitHub Copilot with curated collections of agents, skills, and commands for specific domains or workflows. Each plugin provides:
+
+- **Agents**: Custom agents for specialized tasks
+- **Skills**: Meta-prompts and slash commands
+- **Commands**: Interactive workflows
+- **Documentation**: Setup and usage guides
+
+Plugins are directory-based assets containing:
+- **README.md**: Documentation with metadata
+- **agents/**: Agent definitions
+- **skills/**: Skill definitions
+- **.github/plugin/**: Plugin configuration
+
+**Example:**
+```bash
+# Download a Plugin
+npx workspace-architect download plugins awesome-copilot
+
+# List all Plugins
+npx workspace-architect list plugins
+```
+
 ## Roadmap
 
 See [ROADMAP.md](ROADMAP.md) for our development timeline, upcoming features, and current capabilities.
@@ -226,6 +292,8 @@ Create a JSON file in `assets/collections/`:
   - `npm run sync-agents` - Sync agents from github/awesome-copilot
   - `npm run sync-instructions` - Sync instructions from github/awesome-copilot
   - `npm run sync-skills` - Sync skills from anthropics/skills
+  - `npm run sync-hooks` - Sync hooks from github/awesome-copilot
+  - `npm run sync-plugins` - Sync plugins from github/awesome-copilot
   - Note: Prompts are maintained locally and not synced from upstream
 - `npm run validate-skills` - Validate all synced skills
 

package/assets-manifest.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-04-20T22:22:16.985Z",
+  "generatedAt": "2026-04-28T03:14:21.082Z",
   "assets": {
     "agents": {
       "CSharpExpert": {
@@ -1017,6 +1017,12 @@
         "title": "salesforce-visualforce",
         "type": "agents"
       },
+      "sast-sca-security-analyzer": {
+        "path": "assets/agents/sast-sca-security-analyzer.agent.md",
+        "description": "Use when: performing SAST (Static Application Security Testing), SCA (Software Composition Analysis), scanning source code or binaries for security flaws, auditing third-party dependency vulnerabilities, checking policy compliance, generating structured security reports, identifying CWE-mapped flaws with file/line precision, reviewing open-source license risk, or producing CI/CD-gate security findings.",
+        "title": "sast-sca-security-analyzer",
+        "type": "agents"
+      },
       "scientific-paper-research": {
         "path": "assets/agents/scientific-paper-research.agent.md",
         "description": "Research agent that searches scientific papers and retrieves structured experimental data from full-text studies using the BGPT MCP server.",
@@ -5443,6 +5449,7 @@
           "shared/managed-agents-core.md",
           "shared/managed-agents-environments.md",
           "shared/managed-agents-events.md",
+          "shared/managed-agents-memory.md",
           "shared/managed-agents-onboarding.md",
           "shared/managed-agents-overview.md",
           "shared/managed-agents-tools.md",
@@ -5980,6 +5987,152 @@
           "license": "Proprietary. LICENSE.txt has complete terms"
         }
       }
+    },
+    "hooks": {
+      "governance-audit": {
+        "path": "assets/hooks/governance-audit",
+        "description": "Scans Copilot agent prompts for threat signals and logs governance events",
+        "title": "Governance Audit",
+        "type": "hooks",
+        "files": [
+          "README.md",
+          "audit-prompt.sh",
+          "audit-session-end.sh",
+          "audit-session-start.sh",
+          "hooks.json"
+        ],
+        "metadata": {}
+      },
+      "session-auto-commit": {
+        "path": "assets/hooks/session-auto-commit",
+        "description": "Automatically commits and pushes changes when a Copilot coding agent session ends",
+        "title": "Session Auto-Commit",
+        "type": "hooks",
+        "files": [
+          "README.md",
+          "auto-commit.sh",
+          "hooks.json"
+        ],
+        "metadata": {}
+      },
+      "session-logger": {
+        "path": "assets/hooks/session-logger",
+        "description": "Logs all Copilot coding agent session activity for audit and analysis",
+        "title": "Session Logger",
+        "type": "hooks",
+        "files": [
+          "README.md",
+          "hooks.json",
+          "log-prompt.sh",
+          "log-session-end.sh",
+          "log-session-start.sh"
+        ],
+        "metadata": {}
+      }
+    },
+    "plugins": {
+      "awesome-copilot": {
+        "path": "assets/plugins/awesome-copilot",
+        "description": "",
+        "title": "awesome-copilot",
+        "type": "plugins",
+        "files": [
+          ".github/plugin/plugin.json",
+          "README.md",
+          "agents/meta-agentic-project-scaffold.md",
+          "skills/suggest-awesome-github-copilot-agents/SKILL.md",
+          "skills/suggest-awesome-github-copilot-instructions/SKILL.md",
+          "skills/suggest-awesome-github-copilot-prompts/SKILL.md",
+          "skills/suggest-awesome-github-copilot-skills/SKILL.md"
+        ],
+        "metadata": {}
+      },
+      "azure-cloud-development": {
+        "path": "assets/plugins/azure-cloud-development",
+        "description": "",
+        "title": "azure-cloud-development",
+        "type": "plugins",
+        "files": [
+          ".github/plugin/plugin.json",
+          "README.md",
+          "agents/azure-logic-apps-expert.md",
+          "agents/azure-principal-architect.md",
+          "agents/azure-saas-architect.md",
+          "agents/azure-verified-modules-bicep.md",
+          "agents/azure-verified-modules-terraform.md",
+          "agents/terraform-azure-implement.md",
+          "agents/terraform-azure-planning.md",
+          "skills/az-cost-optimize/SKILL.md",
+          "skills/azure-resource-health-diagnose/SKILL.md"
+        ],
+        "metadata": {}
+      },
+      "cast-imaging": {
+        "path": "assets/plugins/cast-imaging",
+        "description": "",
+        "title": "cast-imaging",
+        "type": "plugins",
+        "files": [
+          ".github/plugin/plugin.json",
+          "README.md",
+          "agents/cast-imaging-impact-analysis.md",
+          "agents/cast-imaging-software-discovery.md",
+          "agents/cast-imaging-structural-quality-advisor.md"
+        ],
+        "metadata": {}
+      },
+      "clojure-interactive-programming": {
+        "path": "assets/plugins/clojure-interactive-programming",
+        "description": "",
+        "title": "clojure-interactive-programming",
+        "type": "plugins",
+        "files": [
+          ".github/plugin/plugin.json",
+          "README.md",
+          "agents/clojure-interactive-programming.md",
+          "skills/remember-interactive-programming/SKILL.md"
+        ],
+        "metadata": {}
+      },
+      "context-engineering": {
+        "path": "assets/plugins/context-engineering",
+        "description": "",
+        "title": "context-engineering",
+        "type": "plugins",
+        "files": [
+          ".github/plugin/plugin.json",
+          "README.md",
+          "agents/context-architect.md",
+          "skills/context-map/SKILL.md",
+          "skills/refactor-plan/SKILL.md",
+          "skills/what-context-needed/SKILL.md"
+        ],
+        "metadata": {}
+      },
+      "copilot-sdk": {
+        "path": "assets/plugins/copilot-sdk",
+        "description": "",
+        "title": "copilot-sdk",
+        "type": "plugins",
+        "files": [
+          ".github/plugin/plugin.json",
+          "README.md",
+          "skills/copilot-sdk/SKILL.md"
+        ],
+        "metadata": {}
+      },
+      "csharp-dotnet-development": {
+        "path": "assets/plugins/csharp-dotnet-development",
+        "description": "",
+        "title": "csharp-dotnet-development",
+        "type": "plugins",
+        "files": [
+          ".github/plugin/plugin.json",
+          "README.md",
+          "agents/expert-dotnet-software-engineer.md"
+        ],
+        "metadata": {}
+      }
     }
   }
 }

package/bin/cli-functions.js

@@ -73,7 +73,9 @@ export function convertYamlItemsToFlat(items) {
     'instruction': 'instructions',
     'prompt': 'prompts',
     'skill': 'skills',
-    'collection': 'collections'
+    'collection': 'collections',
+    'hook': 'hooks',
+    'plugin': 'plugins'
   };
   
   const flatItems = [];
@@ -137,11 +139,17 @@ export async function listAssets(type) {
       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');
+        if ((type === 'skills' || type === 'hooks' || type === 'plugins') && stat.isDirectory()) {
+          // For Skills, Hooks, and Plugins, read README.md from directory
+          let readmePath;
+          if (type === 'skills') {
+            readmePath = path.join(filePath, 'SKILL.md');
+          } else {
+            readmePath = path.join(filePath, 'README.md');
+          }
+          
+          if (await fs.pathExists(readmePath)) {
+            const content = await fs.readFile(readmePath, 'utf8');
             const parsed = matter(content);
             description = parsed.data.description || '';
           }
@@ -165,7 +173,7 @@ export async function listAssets(type) {
 
       // Extract clean name without extensions
       let name;
-      if (type === 'skills' && stat.isDirectory()) {
+      if ((type === 'skills' || type === 'hooks' || type === 'plugins') && stat.isDirectory()) {
         name = file;
       } else if (type === 'collections') {
         name = file.replace(/\.(collection\.)?(yml|yaml|json)$/, '');
@@ -317,6 +325,119 @@ export async function downloadSkill(name, options) {
   console.log(chalk.green(`Successfully downloaded skill ${skillName} to ${destDir} (${skillFiles.length} files)`));
 }
 
+export async function downloadDirectoryAsset(type, name, options) {
+  const assetName = name;
+  let assetFiles = [];
+  let assetPath = '';
+
+  if (IS_LOCAL) {
+    // Local mode: copy from assets/<type>
+    assetPath = path.join(ASSETS_DIR, type, assetName);
+    
+    if (!await fs.pathExists(assetPath)) {
+      throw new Error(`${type} not found: ${type}/${assetName}`);
+    }
+    
+    // Get all files in the asset 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;
+    };
+    
+    assetFiles = await getAllFiles(assetPath);
+  } else {
+    // Production mode: fetch from manifest and download from GitHub
+    const manifest = await getManifest();
+    const asset = manifest.assets[type]?.[assetName];
+    
+    if (!asset) {
+      throw new Error(`${type} not found: ${assetName}`);
+    }
+    
+    assetPath = asset.path;
+    assetFiles = 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', type, assetName);
+  }
+
+  if (options.dryRun) {
+    console.log(chalk.cyan(`[Dry Run] Would create ${type.slice(0, -1)} directory at ${destDir}`));
+    for (const file of assetFiles) {
+      console.log(chalk.cyan(`  Would copy: ${file.relative}`));
+    }
+    return;
+  }
+
+  // Check if asset 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: `${type.charAt(0).toUpperCase() + type.slice(1, -1)} ${assetName} already exists in ${destDir}. Overwrite?`,
+        default: false
+      }
+    ]);
+
+    if (!overwrite) {
+      console.log(chalk.yellow('Operation cancelled.'));
+      return;
+    }
+  }
+
+  console.log(chalk.blue(`Downloading ${type.slice(0, -1)}: ${assetName}`));
+  
+  // Create asset directory
+  await fs.ensureDir(destDir);
+
+  // Download/copy all files
+  for (const file of assetFiles) {
+    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 ${type.slice(0, -1)} ${assetName} to ${destDir} (${assetFiles.length} files)`));
+}
+
 export async function downloadAsset(id, options) {
   const [type, name] = id.split(':');
 
@@ -324,7 +445,7 @@ export async function downloadAsset(id, options) {
     throw new Error('Invalid ID format. Use type:name (e.g., instructions:basic-setup)');
   }
 
-  const validTypes = ['instructions', 'prompts', 'agents', 'skills', 'collections'];
+  const validTypes = ['instructions', 'prompts', 'agents', 'skills', 'hooks', 'plugins', 'collections'];
   if (!validTypes.includes(type)) {
     throw new Error(`Invalid type: ${type}. Valid types are: ${validTypes.join(', ')}`);
   }
@@ -399,6 +520,12 @@ export async function downloadAsset(id, options) {
     return;
   }
 
+  // Handle Hooks and Plugins (multi-file folder-based assets)
+  if (type === 'hooks' || type === 'plugins') {
+    await downloadDirectoryAsset(type, name, options);
+    return;
+  }
+
   // Handle Single Asset
   let content = '';
   let fileName = '';

package/bin/cli.js

@@ -13,18 +13,18 @@ import {
 
 program
   .name('workspace-architect')
-  .description('CLI to download GitHub Copilot instructions, prompts, and agents (alias: wsa)')
+  .description('CLI to download GitHub Copilot instructions, prompts, agents, hooks, plugins, and skills (alias: wsa)')
   .version('1.0.0');
 
 program
   .command('list [type]')
-  .description('List available assets (instructions, prompts, agents, skills, collections)')
+  .description('List available assets (instructions, prompts, agents, skills, hooks, plugins, collections)')
   .action(async (type) => {
     try {
       if (type) {
         await listAssets(type);
       } else {
-        const types = ['instructions', 'prompts', 'agents', 'skills', 'collections'];
+        const types = ['instructions', 'prompts', 'agents', 'skills', 'hooks', 'plugins', 'collections'];
         for (const t of types) {
           await listAssets(t);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workspace-architect",
-  "version": "2.2.76",
+  "version": "2.2.78",
   "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",
@@ -24,6 +24,8 @@
     "sync-prompts": "node scripts/sync-repo.js prompts",
     "sync-collections": "node scripts/sync-repo.js collections",
     "sync-skills": "node scripts/sync-repo.js skills",
+    "sync-hooks": "node scripts/sync-repo.js hooks",
+    "sync-plugins": "node scripts/sync-repo.js plugins",
     "sync-all": "node scripts/sync-repo.js all",
     "validate-skills": "node scripts/analysis/validate-skills.js",
     "validate-assets": "node scripts/analysis/validate-assets.js",