@mytechtoday/augment-extensions 0.1.0

package/modules/coding-standards/typescript/module.json

@@ -0,0 +1,27 @@
+{
+  "name": "typescript-standards",
+  "version": "1.0.0",
+  "displayName": "TypeScript Standards",
+  "description": "Comprehensive TypeScript coding standards and best practices",
+  "type": "coding-standards",
+  "language": "typescript",
+  "author": "Augment Extensions",
+  "license": "MIT",
+  "keywords": ["typescript", "coding-standards", "best-practices", "type-safety"],
+  "dependencies": {},
+  "files": [
+    "rules/naming-conventions.md",
+    "rules/type-safety.md",
+    "rules/error-handling.md",
+    "rules/async-patterns.md",
+    "examples/best-practices.ts"
+  ],
+  "augment": {
+    "minVersion": "1.0.0",
+    "characterCount": 6416,
+    "priority": "high",
+    "category": "coding-standards",
+    "autoLoad": false
+  }
+}
+

package/modules/coding-standards/typescript/rules/naming-conventions.md

@@ -0,0 +1,225 @@
+# TypeScript Naming Conventions
+
+## Core Principles
+
+1. **Clarity over brevity** - Names should be self-documenting
+2. **Consistency** - Follow established patterns throughout codebase
+3. **Avoid abbreviations** - Unless universally understood (e.g., `id`, `url`)
+
+## Variables and Constants
+
+### Variables (camelCase)
+
+```typescript
+// ✅ Good
+const userProfile = getUserProfile();
+const isAuthenticated = checkAuth();
+const totalCount = items.length;
+
+// ❌ Bad
+const up = getUserProfile();
+const auth = checkAuth();
+const cnt = items.length;
+```
+
+### Constants (UPPER_SNAKE_CASE for true constants)
+
+```typescript
+// ✅ Good - True constants
+const MAX_RETRY_ATTEMPTS = 3;
+const API_BASE_URL = 'https://api.example.com';
+const DEFAULT_TIMEOUT_MS = 5000;
+
+// ✅ Good - Configuration objects (camelCase)
+const apiConfig = {
+  baseUrl: 'https://api.example.com',
+  timeout: 5000,
+  retries: 3
+};
+
+// ❌ Bad - Mixing conventions
+const Max_Retry_Attempts = 3;
+const api_base_url = 'https://api.example.com';
+```
+
+## Functions and Methods
+
+### Functions (camelCase, verb-based)
+
+```typescript
+// ✅ Good - Clear action verbs
+function fetchUserData(userId: string): Promise<User> { }
+function validateEmail(email: string): boolean { }
+function transformResponse(data: ApiResponse): User[] { }
+
+// ❌ Bad - Unclear or noun-based
+function user(id: string): Promise<User> { }
+function email(e: string): boolean { }
+function response(d: ApiResponse): User[] { }
+```
+
+### Boolean Functions (is/has/can/should prefix)
+
+```typescript
+// ✅ Good
+function isValidEmail(email: string): boolean { }
+function hasPermission(user: User, permission: string): boolean { }
+function canEditPost(user: User, post: Post): boolean { }
+function shouldRetry(attempt: number): boolean { }
+
+// ❌ Bad
+function validEmail(email: string): boolean { }
+function permission(user: User, perm: string): boolean { }
+function editPost(user: User, post: Post): boolean { }
+```
+
+## Classes and Interfaces
+
+### Classes (PascalCase, noun-based)
+
+```typescript
+// ✅ Good
+class UserRepository { }
+class EmailValidator { }
+class PaymentProcessor { }
+class HttpClient { }
+
+// ❌ Bad
+class userRepository { }
+class validateEmail { }
+class processPayment { }
+class httpClient { }
+```
+
+### Interfaces (PascalCase, descriptive)
+
+```typescript
+// ✅ Good - No 'I' prefix (modern TypeScript convention)
+interface User {
+  id: string;
+  email: string;
+}
+
+interface UserRepository {
+  findById(id: string): Promise<User | null>;
+  save(user: User): Promise<void>;
+}
+
+// ❌ Bad - Hungarian notation
+interface IUser { }
+interface IUserRepository { }
+```
+
+### Type Aliases (PascalCase)
+
+```typescript
+// ✅ Good
+type UserId = string;
+type UserRole = 'admin' | 'user' | 'guest';
+type ApiResponse<T> = {
+  data: T;
+  error?: string;
+};
+
+// ❌ Bad
+type userId = string;
+type user_role = 'admin' | 'user' | 'guest';
+```
+
+## Enums
+
+### Enums (PascalCase for enum, UPPER_SNAKE_CASE for values)
+
+```typescript
+// ✅ Good
+enum UserRole {
+  ADMIN = 'ADMIN',
+  USER = 'USER',
+  GUEST = 'GUEST'
+}
+
+enum HttpStatus {
+  OK = 200,
+  NOT_FOUND = 404,
+  INTERNAL_ERROR = 500
+}
+
+// ❌ Bad
+enum userRole {
+  admin = 'admin',
+  user = 'user'
+}
+```
+
+## Generics
+
+### Generic Type Parameters
+
+```typescript
+// ✅ Good - Descriptive single letter or full word
+function map<T, U>(items: T[], fn: (item: T) => U): U[] { }
+function createRepository<TEntity>(config: Config): Repository<TEntity> { }
+
+// ✅ Good - Multiple related generics
+interface Map<TKey, TValue> {
+  get(key: TKey): TValue | undefined;
+  set(key: TKey, value: TValue): void;
+}
+
+// ❌ Bad - Unclear or inconsistent
+function map<A, B>(items: A[], fn: (item: A) => B): B[] { }
+```
+
+## Files and Directories
+
+### File Names (kebab-case)
+
+```
+// ✅ Good
+user-repository.ts
+email-validator.ts
+payment-processor.ts
+api-client.ts
+
+// ❌ Bad
+UserRepository.ts
+emailValidator.ts
+payment_processor.ts
+```
+
+### Directory Names (kebab-case)
+
+```
+src/
+├── user-management/
+├── payment-processing/
+├── api-clients/
+└── shared-utilities/
+```
+
+## Private Members
+
+### Private Fields (prefix with underscore)
+
+```typescript
+class UserService {
+  // ✅ Good
+  private _cache: Map<string, User>;
+  private _apiClient: HttpClient;
+  
+  // ❌ Bad (no clear indication of privacy)
+  private cache: Map<string, User>;
+  private apiClient: HttpClient;
+}
+```
+
+## Summary
+
+- **Variables/Functions**: camelCase
+- **Classes/Interfaces/Types**: PascalCase
+- **Constants**: UPPER_SNAKE_CASE (true constants) or camelCase (config objects)
+- **Files/Directories**: kebab-case
+- **Booleans**: is/has/can/should prefix
+- **Generics**: T, U, V or descriptive (TEntity, TKey, TValue)
+- **Private**: Prefix with underscore
+

package/modules/workflows/beads/README.md

@@ -0,0 +1,135 @@
+# Beads Workflow Module
+
+**Distributed, git-backed graph issue tracker for AI agents.**
+
+## Overview
+
+Beads provides persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.
+
+## Key Benefits
+
+- **Git as Database**: Issues stored as JSONL in `.beads/` directory, versioned with your code
+- **Agent-Optimized**: JSON output, dependency tracking, auto-ready task detection
+- **Zero Conflict**: Hash-based IDs (`bd-a1b2`) prevent merge collisions in multi-agent workflows
+- **Invisible Infrastructure**: SQLite local cache for speed, background daemon for auto-sync
+- **Memory Decay**: Semantic compaction summarizes old closed tasks to save context window
+
+## Installation Options
+
+### Option 1: With CLI (Recommended)
+
+Install the Beads CLI for full features:
+
+```bash
+# npm
+npm install -g @beads/bd
+
+# Homebrew
+brew install steveyegge/beads/bd
+
+# Go
+go install github.com/steveyegge/beads/cmd/bd@latest
+
+# Initialize in your project
+cd your-project
+bd init
+```
+
+**Benefits**: SQLite cache, auto-sync daemon, validation, JSON output, compaction
+
+### Option 2: Without CLI (Manual)
+
+Work with `.beads/` files directly without installing the CLI. See `rules/manual-setup.md` for instructions.
+
+**Benefits**: No installation required, works immediately
+
+**Limitations**: No SQLite cache, manual sync, no validation, no compaction
+
+## Directory Structure
+
+```
+your-project/
+├── .beads/
+│   ├── issues.jsonl          # All issues (append-only log)
+│   ├── config.json           # Beads configuration
+│   └── cache.db              # SQLite cache (CLI only, gitignored)
+└── AGENTS.md                 # AI agent instructions
+```
+
+## Core Workflow
+
+### Creating Tasks
+
+```bash
+# With CLI
+bd create "Implement user authentication" -p 0
+
+# Without CLI - append to .beads/issues.jsonl
+```
+
+### Viewing Ready Tasks
+
+```bash
+# With CLI
+bd ready
+
+# Shows tasks with no open blockers
+```
+
+### Managing Dependencies
+
+```bash
+# With CLI
+bd dep add <child-id> <parent-id>
+
+# Creates blocks/blocked-by relationships
+```
+
+### Closing Tasks
+
+```bash
+# With CLI
+bd close <id>
+
+# Marks task as closed
+```
+
+## Hierarchical IDs
+
+Beads supports epic/task/subtask hierarchy:
+
+- `bd-a3f8` (Epic)
+- `bd-a3f8.1` (Task)
+- `bd-a3f8.1.1` (Sub-task)
+
+## Stealth Mode
+
+Use Beads locally without committing to the main repo:
+
+```bash
+bd init --stealth
+```
+
+Perfect for personal use on shared projects.
+
+## Character Count
+
+This module contains comprehensive Beads workflow documentation that exceeds the standard `.augment/` folder character limit.
+
+**Total**: ~28,000 characters across all rule files
+
+## Contents
+
+- `rules/workflow.md` - Complete workflow guide
+- `rules/file-format.md` - JSONL file format specification
+- `rules/manual-setup.md` - Manual setup without CLI
+- `rules/commands.md` - CLI command reference
+- `rules/best-practices.md` - Tips and patterns
+- `examples/` - Example workflows and use cases
+
+## Learn More
+
+- **GitHub**: https://github.com/steveyegge/beads
+- **Agent Instructions**: https://github.com/steveyegge/beads/blob/main/AGENT_INSTRUCTIONS.md
+- **Documentation**: See `rules/` directory in this module
+

package/modules/workflows/beads/examples/complete-workflow-example.md

@@ -0,0 +1,278 @@
+# Complete Beads Workflow Example
+
+This example shows a complete Beads workflow from start to finish.
+
+## Scenario
+
+Building a user authentication system with multiple dependent tasks.
+
+## Step 1: Initialize Beads
+
+```bash
+# With CLI
+bd init
+
+# Without CLI
+mkdir .beads
+touch .beads/issues.jsonl
+echo '{"version": "1.0"}' > .beads/config.json
+```
+
+## Step 2: Create Epic
+
+```bash
+# With CLI
+bd create "User Authentication System" -p 0
+# Returns: bd-a3f8
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```json
+{"id":"bd-a3f8","title":"User Authentication System","status":"open","priority":0,"created":"2024-01-20T10:00:00Z","updated":"2024-01-20T10:00:00Z"}
+```
+
+## Step 3: Create Tasks
+
+```bash
+# With CLI
+bd create "Add database schema" -p 0 --parent bd-a3f8
+# Returns: bd-a3f8.1
+
+bd create "Add password hashing" -p 1 --parent bd-a3f8
+# Returns: bd-a3f8.2
+
+bd create "Add JWT generation" -p 1 --parent bd-a3f8
+# Returns: bd-a3f8.3
+
+bd create "Add login endpoint" -p 1 --parent bd-a3f8
+# Returns: bd-a3f8.4
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```jsonl
+{"id":"bd-a3f8.1","title":"Add database schema","status":"open","priority":0,"parent":"bd-a3f8","created":"2024-01-20T10:01:00Z","updated":"2024-01-20T10:01:00Z"}
+{"id":"bd-a3f8.2","title":"Add password hashing","status":"open","priority":1,"parent":"bd-a3f8","created":"2024-01-20T10:02:00Z","updated":"2024-01-20T10:02:00Z"}
+{"id":"bd-a3f8.3","title":"Add JWT generation","status":"open","priority":1,"parent":"bd-a3f8","created":"2024-01-20T10:03:00Z","updated":"2024-01-20T10:03:00Z"}
+{"id":"bd-a3f8.4","title":"Add login endpoint","status":"open","priority":1,"parent":"bd-a3f8","created":"2024-01-20T10:04:00Z","updated":"2024-01-20T10:04:00Z"}
+```
+
+## Step 4: Add Dependencies
+
+```bash
+# With CLI
+bd dep add bd-a3f8.2 bd-a3f8.1  # Password hashing depends on schema
+bd dep add bd-a3f8.3 bd-a3f8.1  # JWT generation depends on schema
+bd dep add bd-a3f8.4 bd-a3f8.2  # Login endpoint depends on password hashing
+bd dep add bd-a3f8.4 bd-a3f8.3  # Login endpoint depends on JWT generation
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```jsonl
+{"id":"bd-a3f8.1","blocks":["bd-a3f8.2","bd-a3f8.3"],"updated":"2024-01-20T10:05:00Z"}
+{"id":"bd-a3f8.2","blocked_by":["bd-a3f8.1"],"blocks":["bd-a3f8.4"],"updated":"2024-01-20T10:05:00Z"}
+{"id":"bd-a3f8.3","blocked_by":["bd-a3f8.1"],"blocks":["bd-a3f8.4"],"updated":"2024-01-20T10:05:00Z"}
+{"id":"bd-a3f8.4","blocked_by":["bd-a3f8.2","bd-a3f8.3"],"updated":"2024-01-20T10:05:00Z"}
+```
+
+## Step 5: Find Ready Tasks
+
+```bash
+# With CLI
+bd ready
+```
+
+**Output**:
+```
+bd-a3f8.1  Add database schema  P0
+```
+
+Only `bd-a3f8.1` is ready because it has no blockers.
+
+## Step 6: Work on First Task
+
+```bash
+# With CLI
+bd update bd-a3f8.1 --status in-progress
+bd comment bd-a3f8.1 "Creating users table with email, password_hash, created_at columns"
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```jsonl
+{"id":"bd-a3f8.1","status":"in-progress","updated":"2024-01-20T11:00:00Z"}
+{"id":"bd-a3f8.1","comments":[{"text":"Creating users table with email, password_hash, created_at columns","timestamp":"2024-01-20T11:00:00Z"}],"updated":"2024-01-20T11:00:00Z"}
+```
+
+## Step 7: Complete First Task
+
+```bash
+# With CLI
+bd close bd-a3f8.1
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```jsonl
+{"id":"bd-a3f8.1","status":"closed","closed":"2024-01-20T12:00:00Z","updated":"2024-01-20T12:00:00Z"}
+```
+
+## Step 8: Find Next Ready Tasks
+
+```bash
+# With CLI
+bd ready
+```
+
+**Output**:
+```
+bd-a3f8.2  Add password hashing  P1
+bd-a3f8.3  Add JWT generation     P1
+```
+
+Now both `bd-a3f8.2` and `bd-a3f8.3` are ready because their blocker (`bd-a3f8.1`) is closed.
+
+## Step 9: Work on Multiple Tasks
+
+```bash
+# With CLI - work on password hashing
+bd update bd-a3f8.2 --status in-progress
+bd comment bd-a3f8.2 "Using bcrypt with cost factor 12"
+
+# Complete it
+bd close bd-a3f8.2
+
+# Work on JWT generation
+bd update bd-a3f8.3 --status in-progress
+bd comment bd-a3f8.3 "Using HS256 algorithm, 24-hour expiry"
+
+# Complete it
+bd close bd-a3f8.3
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```jsonl
+{"id":"bd-a3f8.2","status":"in-progress","updated":"2024-01-20T12:30:00Z"}
+{"id":"bd-a3f8.2","comments":[{"text":"Using bcrypt with cost factor 12","timestamp":"2024-01-20T12:30:00Z"}],"updated":"2024-01-20T12:30:00Z"}
+{"id":"bd-a3f8.2","status":"closed","closed":"2024-01-20T13:00:00Z","updated":"2024-01-20T13:00:00Z"}
+{"id":"bd-a3f8.3","status":"in-progress","updated":"2024-01-20T13:30:00Z"}
+{"id":"bd-a3f8.3","comments":[{"text":"Using HS256 algorithm, 24-hour expiry","timestamp":"2024-01-20T13:30:00Z"}],"updated":"2024-01-20T13:30:00Z"}
+{"id":"bd-a3f8.3","status":"closed","closed":"2024-01-20T14:00:00Z","updated":"2024-01-20T14:00:00Z"}
+```
+
+## Step 10: Complete Final Task
+
+```bash
+# With CLI
+bd ready
+```
+
+**Output**:
+```
+bd-a3f8.4  Add login endpoint  P1
+```
+
+Now `bd-a3f8.4` is ready because both blockers are closed.
+
+```bash
+# With CLI
+bd update bd-a3f8.4 --status in-progress
+bd comment bd-a3f8.4 "POST /api/auth/login endpoint created, returns JWT on success"
+bd close bd-a3f8.4
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```jsonl
+{"id":"bd-a3f8.4","status":"in-progress","updated":"2024-01-20T14:30:00Z"}
+{"id":"bd-a3f8.4","comments":[{"text":"POST /api/auth/login endpoint created, returns JWT on success","timestamp":"2024-01-20T14:30:00Z"}],"updated":"2024-01-20T14:30:00Z"}
+{"id":"bd-a3f8.4","status":"closed","closed":"2024-01-20T15:00:00Z","updated":"2024-01-20T15:00:00Z"}
+```
+
+## Step 11: Close Epic
+
+```bash
+# With CLI
+bd close bd-a3f8
+```
+
+**Without CLI** - Append to `.beads/issues.jsonl`:
+
+```jsonl
+{"id":"bd-a3f8","status":"closed","closed":"2024-01-20T15:00:00Z","updated":"2024-01-20T15:00:00Z"}
+```
+
+## Final State
+
+All tasks completed:
+
+```
+✓ bd-a3f8    User Authentication System
+  ✓ bd-a3f8.1  Add database schema
+  ✓ bd-a3f8.2  Add password hashing
+  ✓ bd-a3f8.3  Add JWT generation
+  ✓ bd-a3f8.4  Add login endpoint
+```
+
+## Viewing History
+
+```bash
+# With CLI
+bd show bd-a3f8.4
+```
+
+**Output**:
+```
+ID: bd-a3f8.4
+Title: Add login endpoint
+Status: closed
+Priority: P1
+Parent: bd-a3f8
+Blocked by: bd-a3f8.2, bd-a3f8.3
+
+Comments:
+  [2024-01-20 14:30] POST /api/auth/login endpoint created, returns JWT on success
+
+Created: 2024-01-20 10:04
+Closed: 2024-01-20 15:00
+```
+
+## AI Agent Workflow
+
+### Creating Tasks
+
+```
+Create a Beads epic for "User Authentication System" with priority 0.
+Then create 4 subtasks:
+1. Add database schema (P0)
+2. Add password hashing (P1)
+3. Add JWT generation (P1)
+4. Add login endpoint (P1)
+
+Add dependencies:
+- Tasks 2 and 3 depend on task 1
+- Task 4 depends on tasks 2 and 3
+```
+
+### Finding Work
+
+```
+What Beads tasks are ready to work on?
+```
+
+### Documenting Progress
+
+```
+Update Beads task bd-a3f8.2 to in-progress.
+Add comment: "Using bcrypt with cost factor 12"
+```
+
+### Completing Tasks
+
+```
+Close Beads task bd-a3f8.2, password hashing is complete.
+```
+