@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/augment-extensions/collections/html-css-js/README.md

@@ -0,0 +1,82 @@
+# HTML/CSS/JS Frontend Collection
+
+Complete frontend development collection bundling HTML, CSS, and JavaScript standards.
+
+## Overview
+
+This collection provides a comprehensive set of coding standards for modern web development by bundling three independent modules:
+
+- **HTML Standards** (`coding-standards/html`)
+- **CSS Standards** (`coding-standards/css`)
+- **JavaScript Standards** (`coding-standards/js`)
+
+## Key Benefits
+
+- **Complete Frontend Coverage**: All three core web technologies in one collection
+- **Modular**: Each module can be used independently if needed
+- **Backward Compatible**: Replaces the monolithic `html-css-js-standards` module
+- **Comprehensive**: Covers semantic HTML, modern CSS, and ES6+ JavaScript
+
+## Installation
+
+### Using the Collection
+
+```bash
+augx link collections/html-css-js
+```
+
+This will automatically link all three modules.
+
+### Using Individual Modules
+
+You can also link modules individually:
+
+```bash
+augx link coding-standards/html
+augx link coding-standards/css
+augx link coding-standards/js
+```
+
+## Included Modules
+
+### HTML Standards (32,477 characters)
+
+- Semantic HTML5 elements
+- Accessibility guidelines (WCAG 2.1)
+- Modern HTML features
+
+### CSS Standards (30,556 characters)
+
+- Modern CSS features (Grid, Flexbox, Custom Properties)
+- Responsive design patterns
+- Preprocessor best practices (Sass, Less)
+
+### JavaScript Standards (101,818 characters)
+
+- ES6+ features and syntax
+- Async patterns (Promises, async/await)
+- DOM manipulation best practices
+- Performance optimization
+- Development tooling
+
+## Total Character Count
+
+~164,851 characters (across all three modules)
+
+## Version
+
+1.0.0
+
+## Backward Compatibility
+
+This collection replaces the monolithic `coding-standards/html-css-js` module. If you were using the old module, you can migrate to this collection seamlessly:
+
+```bash
+augx unlink coding-standards/html-css-js
+augx link collections/html-css-js
+```
+
+## Migration Notes
+
+The collection maintains 100% backward compatibility with the original `html-css-js-standards` module. All rules, examples, and guidelines are preserved in the individual modules.
+

package/augment-extensions/collections/html-css-js/collection.json

@@ -0,0 +1,41 @@
+{
+  "name": "html-css-js",
+  "version": "1.0.0",
+  "displayName": "HTML/CSS/JS Frontend Collection",
+  "description": "Complete frontend development collection bundling HTML, CSS, and JavaScript standards for modern web development",
+  "type": "collection",
+  "tags": ["html", "css", "javascript", "web", "frontend", "collection"],
+  "modules": [
+    {
+      "id": "coding-standards/html",
+      "version": "^1.0.0",
+      "required": true
+    },
+    {
+      "id": "coding-standards/css",
+      "version": "^1.0.0",
+      "required": true
+    },
+    {
+      "id": "coding-standards/js",
+      "version": "^1.0.0",
+      "required": true
+    }
+  ],
+  "augment": {
+    "priority": "high",
+    "category": "collections"
+  },
+  "installation": {
+    "required": false,
+    "steps": [
+      "Link collection using: augx link collections/html-css-js",
+      "This will automatically link all three modules (HTML, CSS, JS)"
+    ]
+  },
+  "backwardCompatibility": {
+    "aliases": ["html/css/js", "html-css-js-standards"],
+    "migrateFrom": "coding-standards/html-css-js"
+  }
+}
+

package/augment-extensions/domain-rules/database/README.md

@@ -0,0 +1,161 @@
+# Database Design and Development Guidelines
+
+Comprehensive guidelines for designing, implementing, and maintaining databases across all major database types.
+
+## Overview
+
+This module provides detailed guidelines for database design and development, covering flat databases, relational databases, NoSQL databases, and vector databases. It includes universal best practices, security standards, performance optimization, migration strategies, and testing approaches.
+
+## Key Benefits
+
+- **Universal Best Practices**: Security, backup, monitoring, and compliance guidelines applicable to all database types
+- **Security Standards**: SQL injection prevention, encryption, access controls, and audit logging
+- **Performance Optimization**: Indexing strategies, query optimization, caching, and profiling
+- **Migration Management**: Schema versioning, zero-downtime migrations, and rollback strategies
+- **Testing Strategies**: Unit testing, integration testing, performance testing, and data validation
+- **Multi-Database Coverage**: Relational (SQL), NoSQL (document, key-value, graph), vector, and flat databases
+
+## Installation
+
+```bash
+augx link domain-rules/database
+```
+
+## Database Types Covered
+
+### Flat Databases
+- CSV/JSON file management
+- Schema validation and enforcement
+- File locking and concurrency
+- When to use and when to migrate
+
+### Relational Databases
+- Schema design and normalization
+- Indexing and query optimization
+- Transactions and ACID properties
+- SQL best practices
+
+### NoSQL Databases
+- Document databases (MongoDB, CouchDB)
+- Key-value stores (Redis, DynamoDB)
+- Graph databases (Neo4j, ArangoDB)
+- Data modeling patterns
+
+### Vector Databases
+- Embedding generation and storage
+- Similarity search and indexing
+- Hybrid search strategies
+- Vector database selection
+
+## Directory Structure
+
+```
+augment-extensions/domain-rules/database/
+├── module.json                          # Module metadata
+├── README.md                            # This file
+├── rules/                               # Detailed guidelines
+│   ├── universal-best-practices.md      # Security, backup, monitoring
+│   ├── security-standards.md            # SQL injection, encryption, access control
+│   ├── performance-optimization.md      # Indexing, caching, profiling
+│   ├── data-migration.md                # Migration planning and execution
+│   ├── testing-strategies.md            # Database testing approaches
+│   ├── relational-databases.md          # SQL database design
+│   ├── schema-design.md                 # Schema design principles
+│   ├── normalization.md                 # Normalization and denormalization
+│   ├── indexing-strategies.md           # Index types and usage
+│   ├── query-optimization.md            # Query performance tuning
+│   ├── transactions.md                  # Transaction management
+│   ├── nosql-databases.md               # NoSQL database patterns
+│   ├── document-databases.md            # Document database design
+│   ├── key-value-stores.md              # Key-value database patterns
+│   ├── graph-databases.md               # Graph database modeling
+│   ├── vector-databases.md              # Vector database design
+│   ├── vector-embeddings.md             # Embedding strategies
+│   ├── vector-indexing.md               # Vector index optimization
+│   └── flat-databases.md                # Flat file database management
+└── examples/                            # Code examples
+    ├── relational-database-example.md   # E-commerce schema example
+    ├── nosql-database-example.md        # Blog platform example
+    ├── vector-database-example.md       # Semantic search example
+    ├── flat-database-example.md         # Configuration management example
+    └── hybrid-database-example.md       # Multi-database architecture
+```
+
+## Core Workflows
+
+### Schema Design
+1. Requirements gathering
+2. Entity identification
+3. Relationship mapping
+4. Normalization decisions
+5. Constraint definition
+6. Index planning
+
+### Migration Management
+1. Migration planning
+2. Schema versioning
+3. Migration script creation
+4. Testing strategy
+5. Rollback planning
+6. Deployment and validation
+
+### Performance Optimization
+1. Performance profiling
+2. Query analysis
+3. Index optimization
+4. Schema optimization
+5. Caching strategies
+6. Monitoring and benchmarking
+
+## Usage Examples
+
+### Schema Design
+```sql
+-- Example: E-commerce database schema
+CREATE TABLE users (
+    id SERIAL PRIMARY KEY,
+    email VARCHAR(255) UNIQUE NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE orders (
+    id SERIAL PRIMARY KEY,
+    user_id INTEGER REFERENCES users(id),
+    total DECIMAL(10, 2) NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX idx_orders_user_id ON orders(user_id);
+CREATE INDEX idx_orders_created_at ON orders(created_at);
+```
+
+### Vector Database
+```python
+# Example: Semantic search with Pinecone
+import pinecone
+from openai import OpenAI
+
+# Initialize
+pinecone.init(api_key="your-api-key")
+index = pinecone.Index("semantic-search")
+
+# Generate embedding
+client = OpenAI()
+response = client.embeddings.create(
+    model="text-embedding-ada-002",
+    input="search query"
+)
+embedding = response.data[0].embedding
+
+# Search
+results = index.query(vector=embedding, top_k=10)
+```
+
+## Character Count
+
+~0 characters (to be calculated after all rules and examples are created)
+
+## Version
+
+1.0.0
+