specweave 0.4.0 → 0.4.1

package/dist/core/types/plugin.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Plugin System Type Definitions
+ *
+ * Defines interfaces and types for the SpecWeave plugin architecture.
+ * Plugins are modular, domain-specific extensions that enhance SpecWeave's capabilities.
+ *
+ * @module core/types/plugin
+ * @version 0.4.0
+ */
+/**
+ * Plugin Manifest - Metadata describing a plugin
+ *
+ * Loaded from .claude-plugin/manifest.json in each plugin directory.
+ * Follows JSON Schema defined in src/core/schemas/plugin-manifest.schema.json
+ */
+export interface PluginManifest {
+    /** Unique plugin name (must start with 'specweave-') */
+    name: string;
+    /** Semantic version (e.g., "1.0.0") */
+    version: string;
+    /** Human-readable description (max 1024 chars) */
+    description: string;
+    /** Plugin author */
+    author?: string;
+    /** License identifier (e.g., "MIT", "Apache-2.0") */
+    license?: string;
+    /** Required SpecWeave core version (e.g., ">=0.4.0") */
+    specweave_core_version: string;
+    /** Plugin dependencies */
+    dependencies?: {
+        /** Other plugins this plugin requires */
+        plugins?: string[];
+    };
+    /** Auto-detection rules for suggesting this plugin */
+    auto_detect?: {
+        /** File/directory patterns to detect (e.g., "kubernetes/", ".git/") */
+        files?: string[];
+        /** NPM package dependencies to detect */
+        packages?: string[];
+        /** Environment variables to detect */
+        env_vars?: string[];
+        /** Git remote pattern (e.g., "github\\.com") */
+        git_remote_pattern?: string;
+    };
+    /** What this plugin provides */
+    provides: {
+        /** Skill names provided by this plugin */
+        skills: string[];
+        /** Agent names provided by this plugin */
+        agents: string[];
+        /** Command names provided by this plugin */
+        commands: string[];
+    };
+    /** Keywords that trigger plugin suggestions in specs/tasks */
+    triggers?: string[];
+    /** Attribution for forked/borrowed plugins */
+    credits?: {
+        /** Upstream source URL if forked */
+        based_on?: string | null;
+        /** Original author name */
+        original_author?: string;
+        /** List of contributors */
+        contributors?: string[];
+        /** Modifications made for SpecWeave */
+        modifications?: string[];
+    };
+}
+/**
+ * Skill - Auto-activating capability
+ */
+export interface Skill {
+    /** Skill name (unique within plugin) */
+    name: string;
+    /** Path to SKILL.md file */
+    path: string;
+    /** Description from SKILL.md frontmatter */
+    description: string;
+    /** Test cases for this skill */
+    testCases?: TestCase[];
+}
+/**
+ * Agent - Specialized role with isolated context
+ */
+export interface Agent {
+    /** Agent name (unique within plugin) */
+    name: string;
+    /** Path to AGENT.md file */
+    path: string;
+    /** System prompt from AGENT.md */
+    systemPrompt: string;
+    /** Agent capabilities */
+    capabilities: string[];
+}
+/**
+ * Command - Slash command (e.g., /specweave.github.sync)
+ */
+export interface Command {
+    /** Command name (e.g., "github-sync") */
+    name: string;
+    /** Path to command.md file */
+    path: string;
+    /** Description of what the command does */
+    description: string;
+    /** Command prompt/template */
+    prompt: string;
+}
+/**
+ * Test Case - YAML-based test case for skills
+ */
+export interface TestCase {
+    /** Test case ID (e.g., "TC-001") */
+    id: string;
+    /** Test description */
+    description: string;
+    /** Input for the skill */
+    input: string;
+    /** Expected output pattern */
+    expected: string;
+    /** Path to test case file */
+    path: string;
+}
+/**
+ * Plugin - Complete plugin with all components loaded
+ */
+export interface Plugin {
+    /** Plugin manifest (metadata) */
+    manifest: PluginManifest;
+    /** Absolute path to plugin directory */
+    path: string;
+    /** Skills provided by this plugin */
+    skills: Skill[];
+    /** Agents provided by this plugin */
+    agents: Agent[];
+    /** Commands provided by this plugin */
+    commands: Command[];
+}
+/**
+ * Plugin Info - Lightweight plugin metadata (for listing)
+ */
+export interface PluginInfo {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Description */
+    description: string;
+    /** Path to plugin directory */
+    path: string;
+    /** Is this plugin currently enabled? */
+    enabled: boolean;
+    /** Skill count */
+    skillCount: number;
+    /** Agent count */
+    agentCount: number;
+    /** Command count */
+    commandCount: number;
+}
+/**
+ * Validation Result - Result of manifest validation
+ */
+export interface ValidationResult {
+    /** Is the manifest valid? */
+    valid: boolean;
+    /** Validation errors (if any) */
+    errors: string[];
+    /** Warnings (non-fatal issues) */
+    warnings: string[];
+}
+/**
+ * Detection Result - Result of plugin auto-detection
+ */
+export interface DetectionResult {
+    /** Detected plugin name */
+    pluginName: string;
+    /** Detection confidence (0-1) */
+    confidence: number;
+    /** Reason for detection */
+    reason: string;
+    /** What triggered detection (file, package, env var, etc.) */
+    trigger: string;
+}
+/**
+ * Plugin Config - User's plugin configuration
+ *
+ * Stored in .specweave/config.yaml
+ */
+export interface PluginConfig {
+    /** List of enabled plugin names */
+    enabled: string[];
+    /** Plugin-specific settings */
+    settings?: {
+        [pluginName: string]: Record<string, any>;
+    };
+}
+/**
+ * Plugin Load Options - Options for loading a plugin
+ */
+export interface PluginLoadOptions {
+    /** Force reload even if already loaded */
+    force?: boolean;
+    /** Skip dependency checking */
+    skipDependencies?: boolean;
+    /** Validate plugin integrity */
+    validate?: boolean;
+}
+/**
+ * Plugin Unload Options - Options for unloading a plugin
+ */
+export interface PluginUnloadOptions {
+    /** Remove plugin files (vs. just marking as disabled) */
+    remove?: boolean;
+    /** Force unload even if other plugins depend on it */
+    force?: boolean;
+}
+/**
+ * Plugin Dependency - Dependency information
+ */
+export interface PluginDependency {
+    /** Plugin name */
+    name: string;
+    /** Version requirement (e.g., ">=1.0.0") */
+    version?: string;
+    /** Is this dependency optional? */
+    optional?: boolean;
+}
+/**
+ * Plugin Error - Custom error for plugin operations
+ */
+export declare class PluginError extends Error {
+    pluginName?: string | undefined;
+    code?: string | undefined;
+    constructor(message: string, pluginName?: string | undefined, code?: string | undefined);
+}
+/**
+ * Plugin Manifest Validation Error
+ */
+export declare class ManifestValidationError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+/**
+ * Plugin Not Found Error
+ */
+export declare class PluginNotFoundError extends PluginError {
+    constructor(pluginName: string);
+}
+/**
+ * Plugin Dependency Error
+ */
+export declare class PluginDependencyError extends PluginError {
+    constructor(message: string, pluginName?: string);
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/core/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/core/types/plugin.ts"],"names":[],"mappings":"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"}

package/dist/core/types/plugin.js

@@ -0,0 +1,48 @@
+/**
+ * Plugin System Type Definitions
+ *
+ * Defines interfaces and types for the SpecWeave plugin architecture.
+ * Plugins are modular, domain-specific extensions that enhance SpecWeave's capabilities.
+ *
+ * @module core/types/plugin
+ * @version 0.4.0
+ */
+/**
+ * Plugin Error - Custom error for plugin operations
+ */
+export class PluginError extends Error {
+    constructor(message, pluginName, code) {
+        super(message);
+        this.pluginName = pluginName;
+        this.code = code;
+        this.name = 'PluginError';
+    }
+}
+/**
+ * Plugin Manifest Validation Error
+ */
+export class ManifestValidationError extends PluginError {
+    constructor(message, pluginName) {
+        super(message, pluginName, 'MANIFEST_INVALID');
+        this.name = 'ManifestValidationError';
+    }
+}
+/**
+ * Plugin Not Found Error
+ */
+export class PluginNotFoundError extends PluginError {
+    constructor(pluginName) {
+        super(`Plugin '${pluginName}' not found`, pluginName, 'PLUGIN_NOT_FOUND');
+        this.name = 'PluginNotFoundError';
+    }
+}
+/**
+ * Plugin Dependency Error
+ */
+export class PluginDependencyError extends PluginError {
+    constructor(message, pluginName) {
+        super(message, pluginName, 'DEPENDENCY_ERROR');
+        this.name = 'PluginDependencyError';
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/core/types/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/core/types/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4RH;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YACE,OAAe,EACR,UAAmB,EACnB,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACtD,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU,aAAa,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/integrations/jira/jira-mapper.d.ts

@@ -8,8 +8,8 @@
  *
  * Syncs with:
  * - .specweave/increments/{id}/ - Increment folder
- * - .specweave/docs/rfcs/ - RFC documents for detailed specs
- * - .specweave/docs/decisions/ - Architecture decisions (ADRs)
+ * - .specweave/docs/internal/architecture/rfc/ - RFC documents for detailed specs
+ * - .specweave/docs/internal/architecture/adr/ - Architecture decisions (ADRs)
  */
 import { JiraClient } from './jira-client';
 export interface SpecWeaveIncrement {

package/dist/integrations/jira/jira-mapper.js

@@ -8,8 +8,8 @@
  *
  * Syncs with:
  * - .specweave/increments/{id}/ - Increment folder
- * - .specweave/docs/rfcs/ - RFC documents for detailed specs
- * - .specweave/docs/decisions/ - Architecture decisions (ADRs)
+ * - .specweave/docs/internal/architecture/rfc/ - RFC documents for detailed specs
+ * - .specweave/docs/internal/architecture/adr/ - Architecture decisions (ADRs)
  */
 import * as fs from 'fs';
 import * as path from 'path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Replace vibe coding with spec-driven development. Smart workflow: /specweave inc auto-closes previous, /specweave build auto-resumes, /specweave progress shows status. PM-led planning, 10 agents, 35+ skills. spec-weave.com",
   "type": "module",
   "main": "dist/index.js",
@@ -14,16 +14,19 @@
     "test": "jest",
     "test:smoke": "bash tests/smoke/e2e-smoke-test.sh",
     "test:e2e": "playwright test tests/e2e/specweave-smoke.spec.ts",
-    "test:integration": "npm run test:integration:ado && npm run test:integration:jira",
-    "test:integration:ado": "ts-node tests/integration/ado-sync/ado-sync.test.ts",
-    "test:integration:jira": "ts-node tests/integration/jira-sync/jira-sync.test.ts",
-    "test:sync:jira": "ts-node tests/integration/jira-sync/jira-bidirectional-sync.test.ts",
-    "test:incremental:jira": "ts-node tests/integration/jira-sync/jira-incremental-sync.test.ts",
-    "generate:tests": "ts-node scripts/generate-tests.ts",
-    "generate:tests:skill": "ts-node scripts/generate-tests.ts",
+    "test:integration": "npm run test:integration:ado && npm run test:integration:jira && npm run test:integration:ml",
+    "test:integration:ado": "npx tsx tests/integration/ado-sync/ado-sync.test.ts",
+    "test:integration:jira": "npx tsx tests/integration/jira-sync/jira-sync.test.ts",
+    "test:integration:ml": "npx tsx tests/integration/ml-pipeline-workflow/ml-pipeline-soccer-detection.test.ts",
+    "test:sync:jira": "npx tsx tests/integration/jira-sync/jira-bidirectional-sync.test.ts",
+    "test:incremental:jira": "npx tsx tests/integration/jira-sync/jira-incremental-sync.test.ts",
+    "test:ml:pipeline": "npx tsx tests/integration/ml-pipeline-workflow/ml-pipeline-soccer-detection.test.ts",
+    "test:ml:real": "npx tsx tests/integration/ml-pipeline-workflow/ml-pipeline-real-video.test.ts",
+    "generate:tests": "npx tsx scripts/generate-tests.ts",
+    "generate:tests:skill": "npx tsx scripts/generate-tests.ts",
     "test:all:generated": "bash scripts/run-all-tests.sh",
     "test:all": "npm test && npm run test:smoke && npm run test:integration",
-    "generate:skills-index": "ts-node src/utils/generate-skills-index.ts",
+    "generate:skills-index": "npx tsx src/utils/generate-skills-index.ts",
     "prepublishOnly": "npm run build",
     "install:agents": "bash bin/install-agents.sh",
     "install:skills": "bash bin/install-skills.sh",
@@ -77,6 +80,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "ajv": "^8.17.1",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
     "fs-extra": "^11.2.0",

package/src/adapters/adapter-base.ts

@@ -16,6 +16,7 @@ import {
   AutomationLevel
 } from './adapter-interface.js';
 import { getDirname } from '../utils/esm-helpers.js';
+import type { Plugin } from '../core/types/plugin.js';
 
 const __dirname = getDirname(import.meta.url);
 
@@ -146,4 +147,36 @@ export abstract class AdapterBase implements IAdapter {
 
     return content;
   }
+
+  /**
+   * Check if this adapter supports plugins
+   * Default: No plugin support (override in concrete adapters)
+   */
+  supportsPlugins(): boolean {
+    return false;
+  }
+
+  /**
+   * Compile and install a plugin
+   * Default: Throw error (override in concrete adapters that support plugins)
+   */
+  async compilePlugin(plugin: Plugin): Promise<void> {
+    throw new Error(`Plugin support not implemented for ${this.name} adapter`);
+  }
+
+  /**
+   * Unload a plugin
+   * Default: Throw error (override in concrete adapters that support plugins)
+   */
+  async unloadPlugin(pluginName: string): Promise<void> {
+    throw new Error(`Plugin support not implemented for ${this.name} adapter`);
+  }
+
+  /**
+   * Get installed plugins
+   * Default: Return empty array (override in concrete adapters that support plugins)
+   */
+  async getInstalledPlugins(): Promise<string[]> {
+    return [];
+  }
 }

package/src/adapters/adapter-interface.ts

@@ -5,6 +5,8 @@
  * Enables SpecWeave to work with ANY AI coding tool (Claude, Cursor, Copilot, etc.)
  */
 
+import type { Plugin } from '../core/types/plugin.js';
+
 export interface AdapterOptions {
   projectPath: string;
   projectName: string;
@@ -117,4 +119,48 @@ export interface IAdapter {
    * @returns string Markdown-formatted instructions
    */
   getInstructions(): string;
+
+  /**
+   * Check if this adapter supports plugins
+   *
+   * Returns true if the adapter can install and compile plugins
+   * (Claude native, Cursor AGENTS.md, Copilot instructions.md)
+   * Returns false for generic/manual adapters
+   *
+   * @returns boolean True if plugins are supported
+   */
+  supportsPlugins(): boolean;
+
+  /**
+   * Compile and install a plugin for this adapter
+   *
+   * Transforms plugin content (skills/agents/commands) to tool-specific format:
+   * - Claude: Copy to .claude/skills/, .claude/agents/, .claude/commands/
+   * - Cursor: Compile to AGENTS.md + team commands JSON
+   * - Copilot: Compile to .github/copilot/instructions.md
+   * - Generic: Generate manual copy-paste instructions
+   *
+   * @param plugin Plugin to compile and install
+   * @returns Promise<void>
+   */
+  compilePlugin(plugin: Plugin): Promise<void>;
+
+  /**
+   * Unload (disable) a plugin for this adapter
+   *
+   * Removes plugin-specific files and restores previous state
+   *
+   * @param pluginName Name of plugin to unload
+   * @returns Promise<void>
+   */
+  unloadPlugin(pluginName: string): Promise<void>;
+
+  /**
+   * Get plugin installation status
+   *
+   * Returns information about which plugins are currently installed
+   *
+   * @returns Promise<string[]> Array of installed plugin names
+   */
+  getInstalledPlugins(): Promise<string[]>;
 }

package/src/adapters/claude/adapter.ts

@@ -12,6 +12,7 @@ import * as path from 'path';
 import fs from 'fs-extra';
 import { AdapterBase } from '../adapter-base.js';
 import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+import type { Plugin } from '../../core/types/plugin.js';
 
 export class ClaudeAdapter extends AdapterBase {
   name = 'claude';
@@ -154,4 +155,167 @@ You're ready to build with SpecWeave on Claude Code!
 For complete documentation, see: .claude/README.md
     `;
   }
+
+  /**
+   * Check if Claude adapter supports plugins
+   *
+   * Claude Code has FULL plugin support via native .claude/ directory
+   *
+   * @returns boolean Always true
+   */
+  supportsPlugins(): boolean {
+    return true;
+  }
+
+  /**
+   * Compile and install a plugin for Claude Code
+   *
+   * Claude uses native plugin installation:
+   * - Copy skills to .claude/skills/{plugin-name}/{skill-name}/
+   * - Copy agents to .claude/agents/{plugin-name}/{agent-name}/
+   * - Copy commands to .claude/commands/
+   *
+   * @param plugin Plugin to install
+   */
+  async compilePlugin(plugin: Plugin): Promise<void> {
+    const projectPath = process.cwd();
+    const claudeDir = path.join(projectPath, '.claude');
+
+    console.log(`\n📦 Installing plugin: ${plugin.manifest.name}`);
+
+    // Ensure base directories exist
+    await fs.ensureDir(path.join(claudeDir, 'skills'));
+    await fs.ensureDir(path.join(claudeDir, 'agents'));
+    await fs.ensureDir(path.join(claudeDir, 'commands'));
+
+    // Install skills
+    for (const skill of plugin.skills) {
+      const targetPath = path.join(claudeDir, 'skills', skill.name);
+      await fs.ensureDir(targetPath);
+
+      // Copy SKILL.md
+      const skillMdPath = path.join(skill.path, 'SKILL.md');
+      if (await fs.pathExists(skillMdPath)) {
+        await fs.copy(skillMdPath, path.join(targetPath, 'SKILL.md'));
+      }
+
+      // Copy test cases if they exist
+      const testCasesDir = path.join(skill.path, 'test-cases');
+      if (await fs.pathExists(testCasesDir)) {
+        await fs.copy(testCasesDir, path.join(targetPath, 'test-cases'));
+      }
+
+      console.log(`   ✓ Skill: ${skill.name}`);
+    }
+
+    // Install agents
+    for (const agent of plugin.agents) {
+      const targetPath = path.join(claudeDir, 'agents', agent.name);
+      await fs.ensureDir(targetPath);
+
+      // Copy AGENT.md
+      const agentMdPath = path.join(agent.path, 'AGENT.md');
+      if (await fs.pathExists(agentMdPath)) {
+        await fs.copy(agentMdPath, path.join(targetPath, 'AGENT.md'));
+      }
+
+      console.log(`   ✓ Agent: ${agent.name}`);
+    }
+
+    // Install commands
+    for (const command of plugin.commands) {
+      // Commands use their full name as filename
+      const fileName = command.name.replace(/\./g, '-') + '.md';
+      const targetPath = path.join(claudeDir, 'commands', fileName);
+
+      if (await fs.pathExists(command.path)) {
+        await fs.copy(command.path, targetPath);
+      }
+
+      console.log(`   ✓ Command: /${command.name}`);
+    }
+
+    console.log(`\n✅ Plugin ${plugin.manifest.name} installed!`);
+  }
+
+  /**
+   * Unload a plugin from Claude Code
+   *
+   * Removes plugin files from .claude/ directory
+   *
+   * @param pluginName Name of plugin to unload
+   */
+  async unloadPlugin(pluginName: string): Promise<void> {
+    const projectPath = process.cwd();
+    const claudeDir = path.join(projectPath, '.claude');
+
+    console.log(`\n🗑️  Unloading plugin: ${pluginName}`);
+
+    // Read plugin manifest to know what to remove
+    const pluginsDir = path.join(projectPath, 'src', 'plugins');
+    const pluginPath = path.join(pluginsDir, pluginName);
+
+    if (!(await fs.pathExists(pluginPath))) {
+      console.warn(`⚠️  Plugin ${pluginName} not found`);
+      return;
+    }
+
+    // Load plugin to get its components
+    const { PluginLoader } = await import('../../core/plugin-loader.js');
+    const loader = new PluginLoader();
+    const plugin = await loader.loadFromDirectory(pluginPath);
+
+    // Remove skills
+    for (const skill of plugin.skills) {
+      const skillPath = path.join(claudeDir, 'skills', skill.name);
+      if (await fs.pathExists(skillPath)) {
+        await fs.remove(skillPath);
+        console.log(`   ✓ Removed skill: ${skill.name}`);
+      }
+    }
+
+    // Remove agents
+    for (const agent of plugin.agents) {
+      const agentPath = path.join(claudeDir, 'agents', agent.name);
+      if (await fs.pathExists(agentPath)) {
+        await fs.remove(agentPath);
+        console.log(`   ✓ Removed agent: ${agent.name}`);
+      }
+    }
+
+    // Remove commands
+    for (const command of plugin.commands) {
+      const fileName = command.name.replace(/\./g, '-') + '.md';
+      const commandPath = path.join(claudeDir, 'commands', fileName);
+      if (await fs.pathExists(commandPath)) {
+        await fs.remove(commandPath);
+        console.log(`   ✓ Removed command: /${command.name}`);
+      }
+    }
+
+    console.log(`\n✅ Plugin ${pluginName} unloaded!`);
+  }
+
+  /**
+   * Get list of installed plugins
+   *
+   * Returns plugin names that are currently installed in .claude/
+   *
+   * @returns Array of installed plugin names
+   */
+  async getInstalledPlugins(): Promise<string[]> {
+    const projectPath = process.cwd();
+    const configPath = path.join(projectPath, '.specweave', 'config.yaml');
+
+    if (!(await fs.pathExists(configPath))) {
+      return [];
+    }
+
+    // Read config to get enabled plugins
+    const yaml = await import('js-yaml');
+    const content = await fs.readFile(configPath, 'utf-8');
+    const config = yaml.load(content) as any;
+
+    return config.plugins?.enabled || [];
+  }
 }