snow-flow 2.0.4 → 2.0.6

package/dist/memory/swarm-memory.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * Snow-Flow Swarm Memory System
+ * Core SQLite database management for agent coordination
+ *
+ * This module provides the foundation for cross-agent communication,
+ * artifact tracking, and performance monitoring.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwarmMemory = void 0;
+const logger_js_1 = require("../utils/logger.js");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+let Database;
+try {
+    Database = require('better-sqlite3');
+}
+catch (error) {
+    console.error('Failed to load better-sqlite3:', error);
+    throw new Error('better-sqlite3 module is required. Please run: npm install better-sqlite3');
+}
+class SwarmMemory {
+    constructor(config = {}) {
+        this.migrationVersion = 1;
+        this.logger = new logger_js_1.Logger('SwarmMemory');
+        this.config = config;
+        // Ensure memory directory exists
+        if (!config.inMemory && !config.dbPath) {
+            const memoryDir = path.join(process.cwd(), '.snow-flow', 'memory');
+            if (!fs.existsSync(memoryDir)) {
+                fs.mkdirSync(memoryDir, { recursive: true });
+            }
+            config.dbPath = path.join(memoryDir, 'swarm-memory.db');
+        }
+        // Initialize database
+        if (config.inMemory) {
+            this.db = new Database(':memory:');
+            this.logger.info('Initialized in-memory database');
+        }
+        else {
+            this.db = new Database(config.dbPath);
+            this.logger.info('Initialized file-based database', { path: config.dbPath });
+        }
+        // Configure database for performance
+        this.configureDatabase();
+        // Run migrations
+        if (config.autoMigrate !== false) {
+            this.migrate();
+        }
+    }
+    configureDatabase() {
+        // Enable foreign keys for data integrity
+        this.db.pragma('foreign_keys = ON');
+        // Optimize for concurrent reads
+        this.db.pragma('journal_mode = WAL');
+        // Increase cache size for better performance
+        this.db.pragma('cache_size = 10000');
+        // Optimize for fast queries
+        this.db.pragma('synchronous = NORMAL');
+        if (this.config.verbose) {
+            this.logger.info('Database configured for optimal performance');
+        }
+    }
+    migrate() {
+        this.logger.info('Running database migrations');
+        // Check current migration version
+        const userVersion = this.db.pragma('user_version', { simple: true });
+        if (userVersion < this.migrationVersion) {
+            this.logger.info(`Migrating from version ${userVersion} to ${this.migrationVersion}`);
+            try {
+                this.db.transaction(() => {
+                    // Create all tables as specified in MCP_ARCHITECTURE.md
+                    this.createTables();
+                    // Create indexes for performance
+                    this.createIndexes();
+                    // Update migration version
+                    this.db.pragma(`user_version = ${this.migrationVersion}`);
+                })();
+                this.logger.info('Migration completed successfully');
+            }
+            catch (error) {
+                this.logger.error('Migration failed', error);
+                throw new Error(`Database migration failed: ${error.message}`);
+            }
+        }
+    }
+    createTables() {
+        // Agent coordination and communication
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_coordination (
+        session_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        agent_type TEXT NOT NULL,
+        status TEXT NOT NULL CHECK (status IN ('spawned', 'active', 'blocked', 'completed', 'failed')),
+        assigned_tasks TEXT NOT NULL,
+        progress_percentage INTEGER DEFAULT 0 CHECK (progress_percentage >= 0 AND progress_percentage <= 100),
+        last_activity TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        current_tool TEXT,
+        error_state TEXT,
+        PRIMARY KEY (session_id, agent_id)
+      );
+    `);
+        // ServiceNow artifact tracking
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS servicenow_artifacts (
+        sys_id TEXT PRIMARY KEY,
+        artifact_type TEXT NOT NULL CHECK (artifact_type IN ('widget', 'flow', 'script', 'business_rule', 'table', 'catalog_item')),
+        name TEXT NOT NULL,
+        description TEXT,
+        created_by_agent TEXT NOT NULL,
+        session_id TEXT NOT NULL,
+        deployment_status TEXT NOT NULL CHECK (deployment_status IN ('created', 'tested', 'deployed', 'verified', 'failed')),
+        update_set_id TEXT,
+        dependencies TEXT, -- JSON array of dependent artifacts
+        metadata TEXT, -- JSON blob of artifact-specific data
+        created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+      );
+    `);
+        // Inter-agent communication
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_messages (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        from_agent TEXT NOT NULL,
+        to_agent TEXT NOT NULL,
+        message_type TEXT NOT NULL CHECK (message_type IN ('handoff', 'dependency_ready', 'error', 'status_update', 'coordination')),
+        content TEXT NOT NULL,
+        artifact_reference TEXT,
+        timestamp TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        processed BOOLEAN DEFAULT FALSE
+      );
+    `);
+        // Shared context between agents
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS shared_context (
+        session_id TEXT NOT NULL,
+        context_key TEXT NOT NULL,
+        context_value TEXT NOT NULL,
+        created_by_agent TEXT NOT NULL,
+        expires_at TIMESTAMP,
+        access_permissions TEXT, -- JSON array of agent types that can access
+        created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        PRIMARY KEY (session_id, context_key)
+      );
+    `);
+        // Deployment tracking
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS deployment_history (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        artifact_sys_id TEXT NOT NULL,
+        deployment_type TEXT NOT NULL CHECK (deployment_type IN ('create', 'update', 'test', 'verify', 'rollback')),
+        success BOOLEAN NOT NULL,
+        deployment_time TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        agent_id TEXT NOT NULL,
+        error_details TEXT,
+        rollback_available BOOLEAN DEFAULT FALSE
+      );
+    `);
+        // Agent dependencies and handoffs
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agent_dependencies (
+        session_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        depends_on_agent TEXT NOT NULL,
+        dependency_type TEXT NOT NULL CHECK (dependency_type IN ('artifact_ready', 'approval_needed', 'data_available', 'task_complete')),
+        artifact_reference TEXT,
+        status TEXT NOT NULL CHECK (status IN ('pending', 'satisfied', 'blocked', 'failed')),
+        created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        satisfied_at TIMESTAMP,
+        PRIMARY KEY (session_id, agent_id, depends_on_agent)
+      );
+    `);
+        // Performance metrics
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS performance_metrics (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        agent_id TEXT NOT NULL,
+        operation_name TEXT NOT NULL,
+        duration_ms INTEGER NOT NULL CHECK (duration_ms >= 0),
+        success BOOLEAN NOT NULL,
+        error_message TEXT,
+        timestamp TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        metadata TEXT -- JSON blob for additional metrics
+      );
+    `);
+    }
+    createIndexes() {
+        // Indexes for agent_coordination
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_agent_coordination_status 
+      ON agent_coordination(status);
+      
+      CREATE INDEX IF NOT EXISTS idx_agent_coordination_session 
+      ON agent_coordination(session_id);
+    `);
+        // Indexes for servicenow_artifacts
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_artifacts_session 
+      ON servicenow_artifacts(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_artifacts_type 
+      ON servicenow_artifacts(artifact_type);
+      
+      CREATE INDEX IF NOT EXISTS idx_artifacts_status 
+      ON servicenow_artifacts(deployment_status);
+    `);
+        // Indexes for agent_messages
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_messages_session 
+      ON agent_messages(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_messages_to_agent 
+      ON agent_messages(to_agent, processed);
+      
+      CREATE INDEX IF NOT EXISTS idx_messages_timestamp 
+      ON agent_messages(timestamp);
+    `);
+        // Indexes for shared_context
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_context_session 
+      ON shared_context(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_context_expires 
+      ON shared_context(expires_at);
+    `);
+        // Indexes for performance_metrics
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_metrics_session 
+      ON performance_metrics(session_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_metrics_agent 
+      ON performance_metrics(agent_id);
+      
+      CREATE INDEX IF NOT EXISTS idx_metrics_timestamp 
+      ON performance_metrics(timestamp);
+    `);
+    }
+    /**
+     * Get the underlying database instance for direct queries
+     */
+    getDatabase() {
+        return this.db;
+    }
+    /**
+     * Prepare a statement for repeated execution
+     */
+    prepare(sql) {
+        return this.db.prepare(sql);
+    }
+    /**
+     * Execute a query and return all results
+     */
+    all(sql, params) {
+        const stmt = this.db.prepare(sql);
+        return params ? stmt.all(...params) : stmt.all();
+    }
+    /**
+     * Execute a query and return the first result
+     */
+    get(sql, params) {
+        const stmt = this.db.prepare(sql);
+        return params ? stmt.get(...params) : stmt.get();
+    }
+    /**
+     * Execute a statement that doesn't return data
+     */
+    run(sql, params) {
+        const stmt = this.db.prepare(sql);
+        return params ? stmt.run(...params) : stmt.run();
+    }
+    /**
+     * Execute multiple statements in a transaction
+     */
+    transaction(fn) {
+        const transaction = this.db.transaction(fn);
+        return transaction();
+    }
+    /**
+     * Clean up expired data
+     */
+    cleanup() {
+        this.logger.info('Running memory cleanup');
+        this.transaction(() => {
+            // Remove expired context
+            this.run(`
+        DELETE FROM shared_context 
+        WHERE expires_at IS NOT NULL AND expires_at < datetime('now')
+      `);
+            // Archive old messages
+            const thirtyDaysAgo = new Date();
+            thirtyDaysAgo.setDate(thirtyDaysAgo.getDate() - 30);
+            this.run(`
+        DELETE FROM agent_messages 
+        WHERE processed = 1 AND timestamp < ?
+      `, [thirtyDaysAgo.toISOString()]);
+            // Archive old performance metrics
+            this.run(`
+        DELETE FROM performance_metrics 
+        WHERE timestamp < ?
+      `, [thirtyDaysAgo.toISOString()]);
+        });
+        // Optimize database
+        this.db.pragma('optimize');
+        this.logger.info('Memory cleanup completed');
+    }
+    /**
+     * Get database statistics
+     */
+    getStats() {
+        const stats = {};
+        const tables = [
+            'agent_coordination',
+            'servicenow_artifacts',
+            'agent_messages',
+            'shared_context',
+            'deployment_history',
+            'agent_dependencies',
+            'performance_metrics'
+        ];
+        for (const table of tables) {
+            const count = this.get(`SELECT COUNT(*) as count FROM ${table}`)?.count || 0;
+            stats[table] = count;
+        }
+        // Add database size
+        const pageCount = this.db.pragma('page_count', { simple: true });
+        const pageSize = this.db.pragma('page_size', { simple: true });
+        if (pageCount && pageSize) {
+            stats.database_size_bytes = pageCount * pageSize;
+        }
+        return stats;
+    }
+    /**
+     * Close the database connection
+     */
+    close() {
+        this.logger.info('Closing database connection');
+        this.db.close();
+    }
+}
+exports.SwarmMemory = SwarmMemory;
+//# sourceMappingURL=swarm-memory.js.map

package/memory/claude-flow-data.json

@@ -0,0 +1,5 @@
+{
+  "agents": [],
+  "tasks": [],
+  "lastUpdated": 1754038214952
+}

package/memory/servicenow_artifacts/000d9224c895221055906c7518aa2d3d.json

@@ -0,0 +1,30 @@
+{
+  "meta": {
+    "sys_id": "000d9224c895221055906c7518aa2d3d",
+    "name": "open_nlu_predict_log0001",
+    "type": "sys_db_object",
+    "last_updated": "2025-05-01 00:51:23"
+  },
+  "structure": {
+    "type": "unknown",
+    "components": []
+  },
+  "context": {
+    "usage": "Context analysis would determine usage patterns",
+    "dependencies": "Related artifacts would be identified here",
+    "impact": "Impact analysis would be performed here"
+  },
+  "relationships": {
+    "relatedArtifacts": [],
+    "dependencies": [],
+    "usage": []
+  },
+  "claudeSummary": "open_nlu_predict_log0001 is a sys_db_object in ServiceNow. It can be modified using natural language instructions through Snow-Flow.",
+  "modificationPoints": [
+    {
+      "location": "main_configuration",
+      "type": "modify_settings",
+      "description": "Main configuration can be modified"
+    }
+  ]
+}

package/memory/servicenow_artifacts/0196b66173303010e46b4a2214f6a7a2.json

@@ -0,0 +1,36 @@
+{
+  "meta": {
+    "sys_id": "0196b66173303010e46b4a2214f6a7a2",
+    "name": "Flow Template Subflow",
+    "type": "sys_hub_flow",
+    "last_updated": "2021-09-29 04:49:06"
+  },
+  "structure": {
+    "type": "flow",
+    "components": {
+      "name": "Flow Template Subflow",
+      "description": "",
+      "active": "false",
+      "trigger": "Unknown trigger",
+      "steps": "Flow definition analysis would go here"
+    }
+  },
+  "context": {
+    "usage": "Context analysis would determine usage patterns",
+    "dependencies": "Related artifacts would be identified here",
+    "impact": "Impact analysis would be performed here"
+  },
+  "relationships": {
+    "relatedArtifacts": [],
+    "dependencies": [],
+    "usage": []
+  },
+  "claudeSummary": "Flow Template Subflow is a sys_hub_flow in ServiceNow. It can be modified using natural language instructions through Snow-Flow.",
+  "modificationPoints": [
+    {
+      "location": "main_configuration",
+      "type": "modify_settings",
+      "description": "Main configuration can be modified"
+    }
+  ]
+}

package/memory/servicenow_artifacts/125e5d1d837e2a102a7ea130ceaad397.json

@@ -0,0 +1,30 @@
+{
+  "meta": {
+    "sys_id": "125e5d1d837e2a102a7ea130ceaad397",
+    "name": "iPhone 6 Request Approval Flow",
+    "type": "wf_workflow",
+    "last_updated": "2025-07-16 17:47:17"
+  },
+  "structure": {
+    "type": "unknown",
+    "components": []
+  },
+  "context": {
+    "usage": "Context analysis would determine usage patterns",
+    "dependencies": "Related artifacts would be identified here",
+    "impact": "Impact analysis would be performed here"
+  },
+  "relationships": {
+    "relatedArtifacts": [],
+    "dependencies": [],
+    "usage": []
+  },
+  "claudeSummary": "iPhone 6 Request Approval Flow is a wf_workflow in ServiceNow. It can be modified using natural language instructions through Snow-Flow.",
+  "modificationPoints": [
+    {
+      "location": "main_configuration",
+      "type": "modify_settings",
+      "description": "Main configuration can be modified"
+    }
+  ]
+}

package/memory/servicenow_artifacts/7637c1f2b7112210a5e5911cde11a972.json

@@ -0,0 +1,30 @@
+{
+  "meta": {
+    "sys_id": "7637c1f2b7112210a5e5911cde11a972",
+    "name": "Prevent invalid language code",
+    "type": "sys_script",
+    "last_updated": "2025-05-18 23:10:10"
+  },
+  "structure": {
+    "type": "unknown",
+    "components": []
+  },
+  "context": {
+    "usage": "Context analysis would determine usage patterns",
+    "dependencies": "Related artifacts would be identified here",
+    "impact": "Impact analysis would be performed here"
+  },
+  "relationships": {
+    "relatedArtifacts": [],
+    "dependencies": [],
+    "usage": []
+  },
+  "claudeSummary": "Prevent invalid language code is a sys_script in ServiceNow. It can be modified using natural language instructions through Snow-Flow.",
+  "modificationPoints": [
+    {
+      "location": "main_configuration",
+      "type": "modify_settings",
+      "description": "Main configuration can be modified"
+    }
+  ]
+}

package/memory/servicenow_artifacts/default_documentation_tables_1754056582292.json

@@ -0,0 +1,55 @@
+{
+  "key": "default:documentation_tables_1754056582292",
+  "data": {
+    "generation_metadata": {
+      "timestamp": "2025-08-01T13:56:22.292Z",
+      "execution_time_ms": 14,
+      "scope": [
+        "tables"
+      ],
+      "format": "markdown",
+      "audience_level": "mixed",
+      "objects_documented": 1,
+      "auto_update_enabled": false
+    },
+    "discovered_objects": [
+      {
+        "type": "table",
+        "name": "incident",
+        "label": "Incident",
+        "description": "Incident management table",
+        "sys_id": "incident_table_id"
+      }
+    ],
+    "documentation_content": {
+      "format": "markdown",
+      "content": "# ServiceNow tables Documentation\n\n*Generated on: 8/1/2025*\n*Objects documented: 1*\n\n## Table of Contents\n\n- [Executive Summary](#executive-summary)\n- [Architecture Overview](#architecture-overview)\n- [table: incident](#table:-incident)\n- [Best Practices and Recommendations](#best-practices-and-recommendations)\n\n\n## Executive Summary\n\nThis documentation covers 1 ServiceNow objects across multiple categories: 1 table.\n\n### Scope:\n- **Documentation Type**: undefined level\n- **Format**: markdown\n- **Coverage**: tables\n- **Generated**: 8/1/2025\n\n### Key Highlights:\n- Comprehensive coverage of core system components\n- Detailed technical specifications and usage guidelines\n- Best practices and recommendations for optimal implementation\n- Architecture diagrams and relationship mappings\n- API documentation not included\n\n### Audience:\nThis documentation is designed for both technical and business stakeholders.\n    \n\n\n## incident\n\n**Type**: table\n**Description**: Incident management table\n\n**System ID**: incident_table_id\n\n### Overview\nIncident management table\n\n### Table Structure\n\n## Incident\n\n**Table Name:** incident\n**Description:** Incident management table\n**Type:** Core ServiceNow Table\n\n### Key Characteristics:\n- Primary table for incident records\n- Extends: task (if applicable)\n- Access controlled by ACLs\n- Supports workflows and business rules\n    \n\n### Field Definitions\n\n### Core Fields:\n- **sys_id**: Unique identifier (32-character GUID)\n- **number**: Auto-generated record number\n- **state**: Current state of the record\n- **priority**: Priority level (1-5)\n- **assigned_to**: User assigned to handle the record\n- **short_description**: Brief description of the issue/request\n- **description**: Detailed description\n\n### Custom Fields:\n_(Document any custom fields added to this table)_\n    \n\n### Relationships\n\n### Parent-Child Relationships:\n- Extends: task table (inherits all task fields)\n- Child tables: None\n\n### Reference Relationships:\n- assigned_to → sys_user\n- caller_id → sys_user (if applicable)\n- cmdb_ci → cmdb_ci (if applicable)\n\n### Related Lists:\n- Approvals\n- Activities (work notes, comments)\n- Attachments\n    \n\n### Dependencies\n- **sys_user** (table): references\n- **task** (table): extends\n- **approval_workflow** (workflow): triggers\n\n### Usage Patterns\n**High Volume Usage**: This object is accessed frequently during business hours\n*Recommendation: Consider performance optimization for peak times*\n\n**Integration Dependency**: Relies on external system integration\n*Recommendation: Ensure proper error handling for integration failures*\n\n### Best Practices\n- Always validate required fields before saving\n- Use proper ACLs to control access\n- Consider performance impact of large datasets\n- Document any custom fields and their purpose\n\n\n\n\n## Best Practices and Recommendations\n\n### General Guidelines:\n- Follow ServiceNow best practices for development and configuration\n- Use proper naming conventions for all objects\n- Document all customizations and configurations\n- Test thoroughly in development before deploying to production\n- Implement proper error handling and logging\n\n### Performance Considerations:\n- Optimize database queries and avoid N+1 query patterns\n- Use appropriate indexes for frequently queried fields\n- Consider caching for frequently accessed data\n- Monitor system performance and resource usage\n\n### Security Best Practices:\n- Implement proper access controls using ACLs\n- Follow principle of least privilege for user permissions\n- Validate all user inputs to prevent security vulnerabilities\n- Regularly review and audit security configurations\n\n### Maintenance and Support:\n- Keep documentation up to date with system changes\n- Implement proper version control for customizations\n- Plan for regular maintenance windows and updates\n- Establish monitoring and alerting for critical processes\n\n### Integration Guidelines:\n- Use standard ServiceNow APIs where possible\n- Implement proper error handling for external integrations\n- Document all integration points and data flows\n- Test integrations thoroughly including failure scenarios\n    \n\n",
+      "filename": "ServiceNow_tables_Documentation.md"
+    },
+    "diagrams": null,
+    "api_documentation": null,
+    "auto_update_config": null,
+    "statistics": {
+      "total_objects": 1,
+      "content_sections": 3,
+      "diagrams_generated": 0,
+      "api_endpoints_documented": 0,
+      "total_words": 538,
+      "estimated_reading_time_minutes": 3
+    },
+    "quality_metrics": {
+      "completeness_score": 60,
+      "accuracy_score": 100,
+      "readability_score": 25,
+      "coverage_percentage": 100
+    }
+  },
+  "timestamp": 1754056582292,
+  "ttl": 604800000,
+  "tags": [],
+  "metadata": {
+    "creator": "ServiceNowAdvancedFeaturesMCP",
+    "version": "1.0.0",
+    "description": "Cached data for key: documentation_tables_1754056582292"
+  }
+}

package/memory/servicenow_artifacts/default_documentation_tables_1754057477189.json

@@ -0,0 +1,55 @@
+{
+  "key": "default:documentation_tables_1754057477189",
+  "data": {
+    "generation_metadata": {
+      "timestamp": "2025-08-01T14:11:17.189Z",
+      "execution_time_ms": 14,
+      "scope": [
+        "tables"
+      ],
+      "format": "markdown",
+      "audience_level": "mixed",
+      "objects_documented": 1,
+      "auto_update_enabled": false
+    },
+    "discovered_objects": [
+      {
+        "type": "table",
+        "name": "incident",
+        "label": "Incident",
+        "description": "Incident management table",
+        "sys_id": "incident_table_id"
+      }
+    ],
+    "documentation_content": {
+      "format": "markdown",
+      "content": "# ServiceNow tables Documentation\n\n*Generated on: 8/1/2025*\n*Objects documented: 1*\n\n## Table of Contents\n\n- [Executive Summary](#executive-summary)\n- [Architecture Overview](#architecture-overview)\n- [table: incident](#table:-incident)\n- [Best Practices and Recommendations](#best-practices-and-recommendations)\n\n\n## Executive Summary\n\nThis documentation covers 1 ServiceNow objects across multiple categories: 1 table.\n\n### Scope:\n- **Documentation Type**: undefined level\n- **Format**: markdown\n- **Coverage**: tables\n- **Generated**: 8/1/2025\n\n### Key Highlights:\n- Comprehensive coverage of core system components\n- Detailed technical specifications and usage guidelines\n- Best practices and recommendations for optimal implementation\n- Architecture diagrams and relationship mappings\n- API documentation not included\n\n### Audience:\nThis documentation is designed for both technical and business stakeholders.\n    \n\n\n## incident\n\n**Type**: table\n**Description**: Incident management table\n\n**System ID**: incident_table_id\n\n### Overview\nIncident management table\n\n### Table Structure\n\n## Incident\n\n**Table Name:** incident\n**Description:** Incident management table\n**Type:** Core ServiceNow Table\n\n### Key Characteristics:\n- Primary table for incident records\n- Extends: task (if applicable)\n- Access controlled by ACLs\n- Supports workflows and business rules\n    \n\n### Field Definitions\n\n### Core Fields:\n- **sys_id**: Unique identifier (32-character GUID)\n- **number**: Auto-generated record number\n- **state**: Current state of the record\n- **priority**: Priority level (1-5)\n- **assigned_to**: User assigned to handle the record\n- **short_description**: Brief description of the issue/request\n- **description**: Detailed description\n\n### Custom Fields:\n_(Document any custom fields added to this table)_\n    \n\n### Relationships\n\n### Parent-Child Relationships:\n- Extends: task table (inherits all task fields)\n- Child tables: None\n\n### Reference Relationships:\n- assigned_to → sys_user\n- caller_id → sys_user (if applicable)\n- cmdb_ci → cmdb_ci (if applicable)\n\n### Related Lists:\n- Approvals\n- Activities (work notes, comments)\n- Attachments\n    \n\n### Dependencies\n- **sys_user** (table): references\n- **task** (table): extends\n- **approval_workflow** (workflow): triggers\n\n### Usage Patterns\n**High Volume Usage**: This object is accessed frequently during business hours\n*Recommendation: Consider performance optimization for peak times*\n\n**Integration Dependency**: Relies on external system integration\n*Recommendation: Ensure proper error handling for integration failures*\n\n### Best Practices\n- Always validate required fields before saving\n- Use proper ACLs to control access\n- Consider performance impact of large datasets\n- Document any custom fields and their purpose\n\n\n\n\n## Best Practices and Recommendations\n\n### General Guidelines:\n- Follow ServiceNow best practices for development and configuration\n- Use proper naming conventions for all objects\n- Document all customizations and configurations\n- Test thoroughly in development before deploying to production\n- Implement proper error handling and logging\n\n### Performance Considerations:\n- Optimize database queries and avoid N+1 query patterns\n- Use appropriate indexes for frequently queried fields\n- Consider caching for frequently accessed data\n- Monitor system performance and resource usage\n\n### Security Best Practices:\n- Implement proper access controls using ACLs\n- Follow principle of least privilege for user permissions\n- Validate all user inputs to prevent security vulnerabilities\n- Regularly review and audit security configurations\n\n### Maintenance and Support:\n- Keep documentation up to date with system changes\n- Implement proper version control for customizations\n- Plan for regular maintenance windows and updates\n- Establish monitoring and alerting for critical processes\n\n### Integration Guidelines:\n- Use standard ServiceNow APIs where possible\n- Implement proper error handling for external integrations\n- Document all integration points and data flows\n- Test integrations thoroughly including failure scenarios\n    \n\n",
+      "filename": "ServiceNow_tables_Documentation.md"
+    },
+    "diagrams": null,
+    "api_documentation": null,
+    "auto_update_config": null,
+    "statistics": {
+      "total_objects": 1,
+      "content_sections": 3,
+      "diagrams_generated": 0,
+      "api_endpoints_documented": 0,
+      "total_words": 538,
+      "estimated_reading_time_minutes": 3
+    },
+    "quality_metrics": {
+      "completeness_score": 60,
+      "accuracy_score": 100,
+      "readability_score": 25,
+      "coverage_percentage": 100
+    }
+  },
+  "timestamp": 1754057477189,
+  "ttl": 604800000,
+  "tags": [],
+  "metadata": {
+    "creator": "ServiceNowAdvancedFeaturesMCP",
+    "version": "1.0.0",
+    "description": "Cached data for key: documentation_tables_1754057477189"
+  }
+}

package/memory/sessions/README.md

@@ -0,0 +1,32 @@
+# Session Memory Storage
+
+## Purpose
+This directory stores session-based memory data, conversation history, and contextual information for development sessions using the Claude-Flow orchestration system.
+
+## Structure
+Sessions are organized by date and session ID for easy retrieval:
+
+```
+memory/sessions/
+├── 2024-01-10/
+│   ├── session_001/
+│   │   ├── metadata.json        # Session metadata and configuration
+│   │   ├── conversation.md      # Full conversation history
+│   │   ├── decisions.md         # Key decisions and rationale
+│   │   ├── artifacts/           # Generated files and outputs
+│   │   └── coordination_state/  # Coordination system snapshots
+│   └── ...
+└── shared/
+    ├── patterns.md              # Common session patterns
+    └── templates/               # Session template files
+```
+
+## Usage Guidelines
+1. **Session Isolation**: Each session gets its own directory
+2. **Metadata Completeness**: Always fill out session metadata
+3. **Conversation Logging**: Document all significant interactions
+4. **Artifact Organization**: Structure generated files clearly
+5. **State Preservation**: Snapshot coordination state regularly
+
+## Last Updated
+2025-08-01T08:50:14.952Z

package/memory/update-set-sessions/01f82af583faea102a7ea130ceaad3d4.json

@@ -0,0 +1,9 @@
+{
+  "update_set_id": "01f82af583faea102a7ea130ceaad3d4",
+  "name": "iPhone 6 Approval Flow",
+  "description": "Flow to check if request is for iPhone 6 and require admin approval for such requests",
+  "user_story": "FLOW-001",
+  "created_at": "2025-07-18T12:30:12.807Z",
+  "state": "in_progress",
+  "artifacts": []
+}