tyx-lab

# tyx-lab

> Atomic building blocks & runnable mini-tools for AI agents, LLM apps, RAG, agentic AI, fintech, and modern software. 219 atoms (23 tools, 117 modules, 79 artifacts) + 7 recipes, distilled from real production systems. MIT. Each atom does one thing and is self-contained.

## Tools (runnable mini-apps, CLIs, MCP servers)

- [Canvas Editor (Fabric.js)](https://github.com/fahmiwol/tyx-lab/tree/main/tools/canvas-editor) (3d/web-app): 2D canvas editor powered by Fabric.js v6. Full-featured drawing, object manipulation, export/import with REST API backend (Express).
- [Image to 3D](https://github.com/fahmiwol/tyx-lab/tree/main/tools/image-to-3d) (3d/web-app): Convert 2D images to interactive 3D models. Upload photos with optional prompts, choose output format (GLB/OBJ/FBX), and preview in real-time with orbit cont...
- [Agentic Framework](https://github.com/fahmiwol/tyx-lab/tree/main/tools/agentic-framework) (ai/script): Lightweight framework for building autonomous agents with tool use, planning, and memory. Supports multiple LLM backends, extensible tool registry, conversat...
- [AI Prompt Lab](https://github.com/fahmiwol/tyx-lab/tree/main/tools/ai-prompt-lab) (ai/web-app): Craft, test, and refine AI prompts. Write positive/negative prompts, choose models and styles, generate images. Save and manage prompts.
- [Background Remover](https://github.com/fahmiwol/tyx-lab/tree/main/tools/bg-remover) (ai/web-app): Remove image backgrounds with AI-powered processing. Upload photos and download PNG with transparent background.
- [TTS Voice Module](https://github.com/fahmiwol/tyx-lab/tree/main/tools/tts-module) (ai/script): Multi-engine Text-to-Speech module with voice cloning support. Supports OpenAI TTS, Coqui XTTS-v2 (self-hosted), and Web Speech API. React component + custom...
- [tyx-lab MCP Server (library brain)](https://github.com/fahmiwol/tyx-lab/tree/main/tools/tyx-lab-mcp) (ai/mcp-server): Search and fetch tyx-lab atoms on demand over MCP — turn the whole 188-atom library into a live, queryable knowledge base for your agent.
- [Content Calendar](https://github.com/fahmiwol/tyx-lab/tree/main/tools/content-calendar) (business/web-app): Editorial calendar for content planning and scheduling. Month/week/day views, drag-drop scheduling, status tracking, team collaboration.
- [Credit & Usage Dashboard](https://github.com/fahmiwol/tyx-lab/tree/main/tools/usage-dashboard) (business/web-app): Real-time credit balance and usage tracking dashboard. Polls backend for credit status, displays 30-day trends with mock data fallback, cost visualization.
- [Embeddable Balance Widget SDK](https://github.com/fahmiwol/tyx-lab/tree/main/tools/embeddable-balance-widget-sdk) (business/tool): JavaScript/React SDK for embedding real-time wallet balance display in partner web apps. Reads from public REST API, handles currency formatting per denomina...
- [Map Generator](https://github.com/fahmiwol/tyx-lab/tree/main/tools/map-generator) (design/web-app): Generate procedural maps from descriptions. Choose size/style (cyberpunk/nature/scifi/fantasy), preview with tile-based rendering, export JSON.
- [Photo Editor](https://github.com/fahmiwol/tyx-lab/tree/main/tools/photo-editor) (design/web-app): Edit photos with 12+ filter presets, brightness/contrast/saturation controls, and sticker overlays.
- [NPC Generator](https://github.com/fahmiwol/tyx-lab/tree/main/tools/npc-generator) (game/web-app): Generate game characters with customizable stats, rarity levels, and roles. Browse roster, export character data, integrate with game worlds.
- [CLI Tool Template](https://github.com/fahmiwol/tyx-lab/tree/main/tools/cli-tool-starter) (infra/cli): Minimal command-line interface template with argument parsing, config storage, and example commands. Adapt for any domain.
- [MCP Server Skeleton](https://github.com/fahmiwol/tyx-lab/tree/main/tools/mcp-server-starter) (infra/mcp-server): Minimal stdio-transport MCP server template with tool registration & example tool. Use as foundation for adapting any service/API to MCP.
- [Platform Connector Adapter](https://github.com/fahmiwol/tyx-lab/tree/main/tools/connector-adapter) (infra/script): Unified API connector layer for social/commerce platforms. Adapters for messaging APIs, analytics feeds, e-commerce integrations. Configurable auth, normaliz...
- [Visual Flow Builder](https://github.com/fahmiwol/tyx-lab/tree/main/tools/visual-flow-builder) (infra/web-app): Browser-based visual flow builder for composing multi-step workflows. Drag-and-drop steps, configure parameters, save as JSON, and execute flows.
- [Log Viewer Dashboard](https://github.com/fahmiwol/tyx-lab/tree/main/tools/log-viewer) (ops/web-app): Real-time reactive log viewer with polling & Socket.io support. Displays structured logs with live refresh, filtering by agent/service, and state synchroniza...
- [Upload Monitor Dashboard](https://github.com/fahmiwol/tyx-lab/tree/main/tools/upload-monitor) (ops/web-app): Real-time file upload monitoring dashboard. Tracks upload progress, file sizes, error rates, queue status with live updates via Socket.io.
- [World Config Editor](https://github.com/fahmiwol/tyx-lab/tree/main/tools/world-editor) (ops/web-app): Monaco-based JSON editor for world.json configuration files. Direct load/save from gateway backend with syntax highlighting and validation.
- [Image to Video](https://github.com/fahmiwol/tyx-lab/tree/main/tools/image-to-video) (video/web-app): Animate static images into videos with AI. Add motion prompts, choose from cinematic/anime/3D styles, set duration and FPS, download MP4.
- [Motion Director MCP — Video Pipeline Tool](https://github.com/fahmiwol/tyx-lab/tree/main/tools/motion-director-mcp) (video/mcp-server): MCP server that exposes the Motion Director AI-video pipeline (idea → Visual DNA → storyboard → keyframes → i2v → voiceover → render) as 18 tools...
- [Video Editor](https://github.com/fahmiwol/tyx-lab/tree/main/tools/video-editor) (video/web-app): Edit videos with trim, text overlay, and audio controls. Multi-track timeline with visual editing. Import, edit, preview, and export videos.

## Modules (importable code)

- [3D Isometric NPC Agent — Random Wander + State Machine](https://github.com/fahmiwol/tyx-lab/tree/main/modules/3d-npc-agent) (3d): AI agent in 3D isometric world with random movement, state machine (idle/walking/working), spawn points, and wander radius. Supports behavior trees and optio...
- [A* Tilemap Pathfinder](https://github.com/fahmiwol/tyx-lab/tree/main/modules/astar-tilemap-pathfinder) (3d): Classic A* pathfinding algorithm for orthogonal tile grids. Supports 4 or 8-direction movement, configurable heuristics (Manhattan/Euclidean), and iteration ...
- [Day Night Cycle](https://github.com/fahmiwol/tyx-lab/tree/main/modules/day-night-cycle) (3d): 24-hour environment cycle for Three.js scenes. Interpolates directional light, ambient light, fog, and clear color through keyframe-defined phases (dawn/day/...
- [Game Loop with Fixed Timestep](https://github.com/fahmiwol/tyx-lab/tree/main/modules/game-loop-fixed-timestep) (3d): requestAnimationFrame game loop with decoupled fixed-rate update (physics/logic) and variable-rate render. Includes frame skip limits, FPS tracking, and inte...
- [Image with Fallback Component](https://github.com/fahmiwol/tyx-lab/tree/main/modules/image-with-fallback) (3d): React component for images with inline fallback SVG on load error. Preserves dims and className. Useful for user-generated content, avatars, product photos.
- [NPC World State Model](https://github.com/fahmiwol/tyx-lab/tree/main/modules/npc-world-state-model) (3d): Declarative JSON schema for representing a room/world state: grid, objects, agents, zones, floors, themes.
- [Orthographic Camera Rig](https://github.com/fahmiwol/tyx-lab/tree/main/modules/orthographic-camera-rig) (3d): Three.js orthographic camera controller with smooth follow, drag-to-pan, mouse wheel zoom, and touch pinch-zoom. Ideal for top-down/isometric games. Handles ...
- [Raycaster Object Picker](https://github.com/fahmiwol/tyx-lab/tree/main/modules/raycaster-object-picker) (3d): Three.js mouse/touch-to-3D object picking via raycasting. Click/tap to select objects, optional hover highlighting with customizable color. Event-driven API ...
- [Sprite Sheet Animator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/sprite-sheet-animator) (3d): Canvas 2D sprite sheet animation player. Manages frame sequences, playback speed, looping, ping-pong, and draw positioning. Ideal for character animations, V...
- [Three.js Scene Bootstrap](https://github.com/fahmiwol/tyx-lab/tree/main/modules/three-scene-bootstrap) (3d): Minimal WebGL scene initialization with renderer, scene, configurable lights, fog, and resize handling. Factory pattern for lights (ambient/directional/hemis...
- [World Renderer Three.js Bootstrap](https://github.com/fahmiwol/tyx-lab/tree/main/modules/world-renderer-three-bootstrap) (3d): Three.js initialization: camera, lights, environment, post-processing, and render loop for isometric world rendering.
- [Agent Cascade Router — LLM-based Tool Selection & Executor Dispatch](https://github.com/fahmiwol/tyx-lab/tree/main/modules/agent-cascade-router) (ai): 2-tier cascade architecture: controller LLM selects tool + executor model, then passes work to specialized executor. Per-agent persona + memory-aware routing...
- [Agent Memory RAG — Obsidian-style Markdown + Wikilinks](https://github.com/fahmiwol/tyx-lab/tree/main/modules/memory-rag) (ai): Per-agent memory system with markdown notes, [[wikilink]] retrieval, and knowledge lineage tracking. Keyword-based retrieval with title boost. Production-rea...
- [Agent Memory: 3-Layer Progressive Retrieval](https://github.com/fahmiwol/tyx-lab/tree/main/modules/agent-memory-3layer-retrieval) (ai): Memory architecture for agents: index layer (FTS5), timeline layer (recent events), full context layer. Reduces token use 10x via progressive retrieval.
- [Agent Persona Registry](https://github.com/fahmiwol/tyx-lab/tree/main/modules/agent-persona-registry) (ai): Unified schema for registering NPC identities, personalities, skills, and role mappings in multi-agent systems.
- [AI Asset Quality Gate](https://github.com/fahmiwol/tyx-lab/tree/main/modules/ai-asset-quality-gate) (ai): Automated quality checks for AI-generated content (title/keyword/disclosure validation + scoring)
- [AI Metadata Stock Generator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/ai-metadata-stock-generator) (ai): Generate title, keywords, description, and AI disclosure for stock marketplace assets
- [AI Provider Router with Fallback](https://github.com/fahmiwol/tyx-lab/tree/main/modules/ai-provider-router-fallback) (ai): Route LLM calls across multiple OpenAI-compatible endpoints with automatic fallback chaining.
- [Behavior Tree & FSM State Model](https://github.com/fahmiwol/tyx-lab/tree/main/modules/behavior-tree-fsm-state-model) (ai): Declarative schema for agent behavior: finite state machine (FSM) with states, transitions, conditions, and actions. Serializable and composable.
- [Brand Schema Validator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/brand-schema-validator) (ai): Zod-based schema for 5-step brand brief intake: positioning, competitive analysis, tone, archetype, cultural context. Validates form input, LLM output, and d...
- [CoT Extractor & Quality Scorer](https://github.com/fahmiwol/tyx-lab/tree/main/modules/cot-extractor) (ai): Extract chain-of-thought from LLM. Parse <REASONING> & <ANSWER> blocks. Score reasoning quality (weak/adequate/strong). Detect epistemik labels [FACT]/[OPINI...
- [Dialogue Tree: Branching Narrative Model](https://github.com/fahmiwol/tyx-lab/tree/main/modules/dialogue-tree-branching-narrative) (ai): Declarative dialogue tree for NPC conversations: branches, conditions, player choices, dialogue outcomes. Serializable for save/load and branching narratives.
- [Epistemology Framework (Islamic)](https://github.com/fahmiwol/tyx-lab/tree/main/modules/epistemology-framework) (ai): Islamic epistemology engine. Sanad chains, yaqin levels (ilm/ain/haqq), mutawatir/ahad tiers, maqashid al-shariah alignment, 4 cognitive modes.
- [Jungian Archetype Selector](https://github.com/fahmiwol/tyx-lab/tree/main/modules/jungian-archetype-selector) (ai): Canonical 12 Jungian brand archetypes mapped to quadrants with voice markers, core desires, and brand examples — for strategic positioning and narrative co...
- [LLM Provider Registry Switchable](https://github.com/fahmiwol/tyx-lab/tree/main/modules/llm-provider-registry-switchable) (ai): Declarative multi-provider LLM registry with fallback support (OpenRouter, HF, OpenAI, Anthropic, Gemini, custom)
- [Multi-Provider AI Router](https://github.com/fahmiwol/tyx-lab/tree/main/modules/ai-router) (ai): Unified LLM client with auto-fallback: Gemini→Cerebras→OpenAI→Anthropic→Pollinations. Prioritizes BYOK.
- [Multi-Provider AI Router](https://github.com/fahmiwol/tyx-lab/tree/main/modules/ai-router-fallback) (ai): Fallback AI content provider with priority: Groq (free) → Gemini (free) → Ollama (local) → Anthropic. Handles timeouts, fallback, and unified response ...
- [ReAct Reasoning Loop](https://github.com/fahmiwol/tyx-lab/tree/main/modules/react-reasoning-loop) (ai): Reason + Act loop for agentic systems. Thought -> Action -> Observation cycling with max steps & anti-loop safeguards.
- [Sanad Verifier (Multi-Source)](https://github.com/fahmiwol/tyx-lab/tree/main/modules/sanad-verifier) (ai): Cross-verify factual claims across web + corpus + LLM-prior. Reject hallucinations for fact-checkable, brand-specific, current-event claims. Sanad chain vali...
- [Self-Refining Agent Loop (Tafakkur Pattern)](https://github.com/fahmiwol/tyx-lab/tree/main/modules/agent-self-refine-loop) (ai): Dual-agent criticism loop: innovator generates → critic evaluates across multiple modes → refine or accept. Prevents single-pass mediocrity; compound qua...
- [Server-Sent Event Chat Stream Parser](https://github.com/fahmiwol/tyx-lab/tree/main/modules/sse-chat-stream-parser) (ai): Parse SSE frames from LLM/chat streaming endpoints. Tolerant of multiple JSON payload formats (token/delta/content/text variants), plain text fallback, and f...
- [Skill Registry Contract Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/modules/skill-registry-contract) (ai): Contract-enforced skill registry with boot-time validation: description and parameters mandatory, tools self-documenting.
- [Telegram Command Router & Inline Keyboard Builder](https://github.com/fahmiwol/tyx-lab/tree/main/modules/telegram-command-router) (ai): Route Telegram bot commands to handlers and build inline keyboard UI with callback actions.
- [Tile Grid Coordinator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/tile-grid-coordinator) (ai): Pure grid coordinate conversion utility for top-down and isometric tile maps (RPG/Gather-style). Square tiles, screen offset support, Manhattan distance, bou...
- [Tools Catalogue Schema](https://github.com/fahmiwol/tyx-lab/tree/main/modules/tools-catalogue-schema) (ai): Unified registry schema for media providers, LLM vendors, and callable tools with free/paid status, fallback chains, and compatibility.
- [TTS Provider Wrapper](https://github.com/fahmiwol/tyx-lab/tree/main/modules/tts-provider-wrapper) (ai): Abstraction layer for TTS services (OpenAI, Google Cloud, Azure) with caching, rate limiting, and streaming output. Normalizes provider APIs into unified int...
- [Admin Approval Workflow — Maker-Checker Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/modules/admin-approval-maker-checker) (business): Four-eye approval system for high-value or sensitive operations (withdrawals, rate changes, supply adjustments). Separates initiation (Maker) from authorizat...
- [Append-Only Audit Log](https://github.com/fahmiwol/tyx-lab/tree/main/modules/audit-log-pattern) (business): Immutable append-only audit trail for fintech/compliance. Dual-track user + admin logs with soft-fail, denormalization, and request metadata capture.
- [Command Intent Router](https://github.com/fahmiwol/tyx-lab/tree/main/modules/command-intent-router) (business): Parse text commands and route to intent handlers. Supports regex patterns, fuzzy matching, and parameter extraction.
- [Currency Formatter & Conversion](https://github.com/fahmiwol/tyx-lab/tree/main/modules/currency-formatter) (business): Format and convert between IDR and USD. Rate stored in DB or env, with fallback. Display helpers for prices with/without conversions.
- [Denomination Unit Price Resolver](https://github.com/fahmiwol/tyx-lab/tree/main/modules/denomination-unit-price-resolver) (business): Lookup table: Denomination → IDR unit price. Resolves GOLD, SILVER, BRONZE, DIAMOND to fiat value. Supports versioned snapshots for historical settlement +...
- [Design Tokens Generator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/design-tokens-generator) (business): Complete design token system (colors, typography, spacing, radius, shadow) — compiles to CSS custom properties and Tailwind preset.
- [Double-Entry Ledger](https://github.com/fahmiwol/tyx-lab/tree/main/modules/double-entry-ledger) (business): Immutable transaction ledger for fintech: P2P transfers, conversions with fees, mint/reward/withdraw operations. Includes denormalized balances and coin-leve...
- [Email Template Builder](https://github.com/fahmiwol/tyx-lab/tree/main/modules/email-template-builder) (business): Compile email templates with safe variable substitution and reusable partials.
- [Idempotent Payment Processing](https://github.com/fahmiwol/tyx-lab/tree/main/modules/idempotent-payment-processing) (business): Prevent duplicate transactions from webhook retries using deterministic idempotency keys. Guards against double-crediting users.
- [Intent Pattern Matcher](https://github.com/fahmiwol/tyx-lab/tree/main/modules/intent-pattern-matcher) (business): Static rule-based intent classifier for domain language (Indonesian commerce: stock check, production logging, sales). Avoids LLM calls by pattern matching s...
- [Message Pipeline Router](https://github.com/fahmiwol/tyx-lab/tree/main/modules/message-pipeline-router) (business): Inbound webhook message handler with intent parsing and action dispatch. Normalizes multi-channel input (WhatsApp, Telegram) → parses intent via rules or L...
- [Minimal Session Cookie Auth](https://github.com/fahmiwol/tyx-lab/tree/main/modules/minimal-session-cookie) (business): HMAC-SHA256 signed session tokens (no external auth library). Payload: base64(json).signature. Stores in httpOnly cookie with 14-day TTL.
- [Multi-Denomination Wallet Balance](https://github.com/fahmiwol/tyx-lab/tree/main/modules/multi-denom-wallet-balance) (business): Track wallet balances across 4+ currency types (GOLD/SILVER/BRONZE/DIAMOND) with real-time fiat conversion. Returns normalized balance object: { walletId, us...
- [Multi-Tenant Granular Privilege System (PHP/MySQL)](https://github.com/fahmiwol/tyx-lab/tree/main/modules/multi-tenant-privilege) (business): Role-based access control with per-module granular permissions (can_view, can_create, can_edit, can_delete). Supports super admin full access and caching in ...
- [Nodemailer Email Template](https://github.com/fahmiwol/tyx-lab/tree/main/modules/nodemailer-email-template) (business): Email dispatch via nodemailer with SMTP relay. Graceful fallback if SMTP unconfigured. Built-in HTML templates for common SaaS flows (purchase, reset, invite).
- [Phone Normalization](https://github.com/fahmiwol/tyx-lab/tree/main/modules/phone-normalization) (business): Normalize and validate phone numbers for Southeast Asia (Indonesia 62). Handles leading zeros, country codes, and formats for WhatsApp/messaging APIs.
- [Social Post Auto-Scheduler](https://github.com/fahmiwol/tyx-lab/tree/main/modules/social-post-scheduler) (business): Background worker (60s interval) that publishes scheduled social posts when scheduled_at <= now(). Supports batch processing, transactional updates, and logg...
- [Statement & Receipt Generator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/statement-receipt-generator) (business): On-demand PDF generation of transaction statements and receipts. Supports date range filtering, denomination breakdown, QR code embedding for verification, a...
- [Tiered Quota & Rate-Limit Resolver](https://github.com/fahmiwol/tyx-lab/tree/main/modules/tiered-quota-resolver) (business): Check daily usage quota across tiers (admin/pro/free/anon). Supports IP-based hashing for anonymous users, cookie-based auth (admin/user tokens), and coin de...
- [Transfer Intent Checkout State](https://github.com/fahmiwol/tyx-lab/tree/main/modules/transfer-intent-checkout-state) (business): Embeddable payment checkout lifecycle: (1) Client creates intent via public API key, (2) Proxy forwards to bank with internal key (CORS-safe), (3) User confi...
- [Trigger-Based Reward Schedule](https://github.com/fahmiwol/tyx-lab/tree/main/modules/trigger-reward-schedule) (business): Maps activity triggers (VIDEO_WATCH, QUIZ_COMPLETE, MISSION, etc.) → default reward amounts. Each trigger row: { trigger, label, defaultAmount, icon, descr...
- [Wallet Denomination Ledger](https://github.com/fahmiwol/tyx-lab/tree/main/modules/wallet-denomination-ledger) (business): Append-only transaction log per wallet, per denomination. Tracks all movements: TRANSFER in/out, MINT received, BURN removed, HOLD reserved, SETTLE debit. Su...
- [Workflow DAG Executor](https://github.com/fahmiwol/tyx-lab/tree/main/modules/workflow-dag-executor) (business): Validate a workflow DAG (node integrity, cycle detection) and simulate/execute nodes in dependency order.
- [Workflow Node Registry Builder](https://github.com/fahmiwol/tyx-lab/tree/main/modules/workflow-node-registry-builder) (business): Extensible registry of workflow node types with ports, executors, and UI metadata.
- [Sales Pipeline Stage Machine](https://github.com/fahmiwol/tyx-lab/tree/main/modules/sale-pipeline-stages) (crm): Sales pipeline stage machine with SLA tracking and terminal state detection.
- [Action Guarded Executor](https://github.com/fahmiwol/tyx-lab/tree/main/modules/action-guarded-executor) (infra): Wraps any callable with guard layers: health check → circadian check → rate-limit → think delay → execute. Returns structured ActionResult with timin...
- [Adaptive Rate Limiter with Warmup](https://github.com/fahmiwol/tyx-lab/tree/main/modules/adaptive-rate-limiter-warmup) (infra): Per-entity rate limiter with age-based warmup curve (0.08→1.0 over 21 days), jittered intervals, daily caps, and persistent state.
- [AES-256-GCM Secret Encrypt/Decrypt](https://github.com/fahmiwol/tyx-lab/tree/main/modules/aes-256-gcm-secret) (infra): Encrypt/decrypt sensitive data (API keys, tokens, secrets) with AES-256-GCM. Output: base64(iv || authTag || ciphertext). Key derived from env var via SHA-256.
- [Atomic JSON File Store](https://github.com/fahmiwol/tyx-lab/tree/main/modules/json-store-persistence) (infra): Concurrency-safe file-based JSON storage with atomic write (temp+rename), read, and update.
- [Audio Chunk Streamer](https://github.com/fahmiwol/tyx-lab/tree/main/modules/audio-chunk-streamer) (infra): HTTP streaming for large audio files with chunked transfer encoding. Supports range requests, pause/resume, and adaptive bitrate.
- [Auth Session Token Manager](https://github.com/fahmiwol/tyx-lab/tree/main/modules/auth-session-token-manager) (infra): In-memory session + token auth with bcrypt hashing and Express middleware
- [B2B API-Key Gateway Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/modules/b2b-api-key-gateway-pattern) (infra): Multi-tier API key management for platform partners. Supports key rotation, rate limiting per API key, transaction signing with shared secrets, and read-only...
- [Browser Automation Engine](https://github.com/fahmiwol/tyx-lab/tree/main/modules/browser-automation-engine) (infra): Anti-detection browser launcher (patchright > playwright-extra > playwright). Supports Browserbase/Steel cloud.
- [BullMQ Job Enqueuer](https://github.com/fahmiwol/tyx-lab/tree/main/modules/bullmq-job-enqueuer) (infra): Wrapper for BullMQ queue with exponential backoff, retry policy, and auto-cleanup. Standardizes job enqueueing for e-commerce workflows (scrape, process, ship).
- [Dual-Auth Internal Key Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/modules/dual-auth-internal-key-pattern) (infra): Server-to-server + user authentication hybrid: (1) Client sends JWT (user auth), (2) Server adds x-internal-key header (server auth). Prevents MITM impersona...
- [Embedding Model Loader (3-Way)](https://github.com/fahmiwol/tyx-lab/tree/main/modules/embedding-model-loader) (infra): Lazy-load embedding models: BGE-M3 (default, multilingual), Mamba2 (best quality), MiniLM (CPU fallback). Graceful disable if dependencies missing.
- [Environment Config Schema](https://github.com/fahmiwol/tyx-lab/tree/main/modules/env-config-schema) (infra): Pydantic-based environment variable configuration with type coercion, validation, and defaults. Single source of truth for app settings across all modules.
- [Exchange Rate Oracle Updater](https://github.com/fahmiwol/tyx-lab/tree/main/modules/exchange-rate-oracle-updater) (infra): Trusted price feed mechanism that updates denomination-to-fiat conversion rates via authenticated oracle transactions. Supports historical rate tracking, rat...
- [Exponential Backoff Queue](https://github.com/fahmiwol/tyx-lab/tree/main/modules/exponential-backoff-queue) (infra): BullMQ queue configuration with exponential backoff retry strategy. Prevents thundering herd, includes auto-cleanup, and supports preset strategies (default,...
- [Flow DAG Executor](https://github.com/fahmiwol/tyx-lab/tree/main/modules/flow-dag-executor) (infra): Executes declarative node DAG from JSON: trigger, action, foreach, filter, spinner, delay. Variables via {{path.binding}}. Logs all node executions.
- [Human-Like Timing Utilities](https://github.com/fahmiwol/tyx-lab/tree/main/modules/human-timing-utils) (infra): Sleep/delay helpers: typing speed, page reads, request gaps. For realistic bot behavior & rate-limit avoidance.
- [JSON File Store — Atomic](https://github.com/fahmiwol/tyx-lab/tree/main/modules/json-file-store-atomic) (infra): Atomic ACID-like JSON file-based storage with read/write/update and recovery
- [JWT Auth Cookies](https://github.com/fahmiwol/tyx-lab/tree/main/modules/jwt-auth-cookies) (infra): JWT-based authentication with secure httpOnly cookies, refresh token rotation, and access token expiry. Handles auth state across SPA + API.
- [JWT Token Helper](https://github.com/fahmiwol/tyx-lab/tree/main/modules/jwt-token-helper) (infra): Create and validate JWT access tokens with configurable TTL. Handles token generation, validation, claim extraction, and error cases for FastAPI services.
- [Media Provider Fallback Orchestrator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/media-provider-fallback-orchestrator) (infra): Orchestrate calls to media providers (image, video, audio, design) with automatic fallback on failure and cost/quota tracking.
- [Meta Webhook Verifier](https://github.com/fahmiwol/tyx-lab/tree/main/modules/webhook-meta-verify) (infra): Verify Meta Cloud API webhook challenge-response and HMAC-SHA256 signatures. Validates webhook authenticity and prevents spoofing for WhatsApp/Messenger inte...
- [Multi-Entity Scheduler](https://github.com/fahmiwol/tyx-lab/tree/main/modules/multi-entity-scheduler) (infra): Schedules recurring tasks across many entities (accounts/bots) with per-entity stagger, jittered intervals, health + circadian checks.
- [Parallel Tool Executor](https://github.com/fahmiwol/tyx-lab/tree/main/modules/parallel-tool-executor) (infra): Concurrent execution of independent tool calls using ThreadPoolExecutor. Bundle-by-bundle execution with dependency support.
- [Password Hashing with Scrypt](https://github.com/fahmiwol/tyx-lab/tree/main/modules/password-scrypt-hash) (infra): Hash and verify passwords using scrypt (Node built-in crypto). Format: hexSalt:hexKey. No native dependencies. Timing-safe comparison.
- [Prisma Lifecycle Service](https://github.com/fahmiwol/tyx-lab/tree/main/modules/prisma-lifecycle-service) (infra): NestJS injectable Prisma service with automatic connection management. Implements OnModuleInit/OnModuleDestroy for graceful startup and shutdown; includes he...
- [Provider Registry — Data-Driven LLM/Media Provider Config](https://github.com/fahmiwol/tyx-lab/tree/main/modules/provider-registry) (infra): Catalog of available providers (LLM routers, executors, media services) loaded from JSON config. Zero code changes to add providers. Used by agents to pick e...
- [Rate-Limited Message Queue Scheduler](https://github.com/fahmiwol/tyx-lab/tree/main/modules/message-queue-scheduler) (infra): Batching queue with per-destination throttling and retry for scheduled/bulk dispatch.
- [Redis Queue Wrapper](https://github.com/fahmiwol/tyx-lab/tree/main/modules/redis-queue-wrapper) (infra): Factory pattern for Redis connection pooling and RQ queue management. Provides singleton Redis connection and named queues for reliable task enqueueing.
- [Relative Timestamp Formatter](https://github.com/fahmiwol/tyx-lab/tree/main/modules/relative-timestamp-formatter) (infra): Format dates as human-readable relative timestamps (5m ago, 2h ago) and locale-aware time strings. Zero dependencies; works in browsers and Node.
- [Request Guard Sentinel](https://github.com/fahmiwol/tyx-lab/tree/main/modules/request-guard-sentinel) (infra): Per-entity request health tracker: classify error signals (challenge/rate-limit/auth-fail/blocked), track 3-state health (healthy/cooling/quarantined), autom...
- [Rotating User-Agent Pool](https://github.com/fahmiwol/tyx-lab/tree/main/modules/rotating-useragents) (infra): Real browser UAs (2026 updated), weighted by market share. Chrome 65%, mobile 15%, Firefox 5%, Safari 10%, Edge 5%.
- [Safe localStorage Wrapper](https://github.com/fahmiwol/tyx-lab/tree/main/modules/safe-localstorage-wrapper) (infra): Browser localStorage with graceful fallback on quota exceeded or unavailability. JSON serialization, prefixed keys, silent error handling, returns defaults o...
- [Semantic Response Cache (2-Tier)](https://github.com/fahmiwol/tyx-lab/tree/main/modules/semantic-response-cache) (infra): In-memory LRU cache + optional semantic matching. Phase A: exact TTL-LRU. Phase B: embedding-based fuzzy match for similar queries.
- [Server Auth Token Cache](https://github.com/fahmiwol/tyx-lab/tree/main/modules/server-auth-token-cache) (infra): Self-healing JWT token cache for backend services. Auto-refresh when expiry approaches (60s buffer). Graceful fallback to static token. Extracts exp claim fr...
- [Stealth Fetch Engine](https://github.com/fahmiwol/tyx-lab/tree/main/modules/stealth-fetch-engine) (infra): curl-based HTTP client with anti-detection via TLS fingerprinting bypass, rotating UA, Chrome headers. Evades WAF blocks.
- [Sticky Proxy Pool Manager](https://github.com/fahmiwol/tyx-lab/tree/main/modules/sticky-proxy-pool-manager) (infra): Pool-based proxy manager with 1:1 sticky entity→proxy binding. Same entity always uses same IP (residential/datacenter/VPN). Rotation is across entities. J...
- [Token Burn & Redemption Audit Trail](https://github.com/fahmiwol/tyx-lab/tree/main/modules/token-burn-redemption-audit) (infra): Immutable ledger of token burn events with cryptographic commitment. Records burn reason, timestamp, authorizer, and withdrawal destination. Enables forensic...
- [Token Supply Cap & Reserve Accounting](https://github.com/fahmiwol/tyx-lab/tree/main/modules/token-supply-cap-accounting) (infra): Tracks minted, burned, and circulating supply across denominations with hard limits per tier. Computes remaining mintable reserve and validates cap enforceme...
- [Webhook Dispatcher](https://github.com/fahmiwol/tyx-lab/tree/main/modules/webhook-dispatcher) (infra): Fan-out webhook dispatcher for multiple integrations with configurable timeout and error handling. Posts events to active endpoints, logs responses for audit...
- [Webhook Meta Header Validator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/webhook-meta-header-validator) (infra): Validate Meta (WhatsApp/Facebook/Instagram) webhook signature using HMAC-SHA256. Prevents replay/spoofing attacks.
- [WhatsApp Multi-Device Session Connector](https://github.com/fahmiwol/tyx-lab/tree/main/modules/wa-session-baileys-connector) (infra): Manage WhatsApp multi-device sessions with per-tenant isolation, QR auth, and auto-reconnect.
- [Brute Force Login Guard](https://github.com/fahmiwol/tyx-lab/tree/main/modules/brute-force-login-guard) (ops): Rate limiter for login attempts using IP+identifier tracking. Prevents credential stuffing with configurable window (15min default).
- [CSRF Security Guard](https://github.com/fahmiwol/tyx-lab/tree/main/modules/csrf-security-guard) (ops): CSRF token generation, validation, and session security hardening with HttpOnly + Secure + SameSite cookies.
- [Database Sequential Number Generator](https://github.com/fahmiwol/tyx-lab/tree/main/modules/db-numseq-generator) (ops): Generate sequential document/invoice numbers with prefix, period (YYYYMM), and auto-increment. Useful for invoices, orders, leads.
- [Deploy Helper Scripts](https://github.com/fahmiwol/tyx-lab/tree/main/modules/deploy-helpers) (ops): Reusable bash for Node.js SaaS: NVM detection, git pull, npm install, build, PM2 restart. Timestamped logging.
- [Multi-Channel Alert Notifier](https://github.com/fahmiwol/tyx-lab/tree/main/modules/notifier) (ops): Alert dispatch via WhatsApp, email, logs with throttling (1/hour per source+provider+level).
- [Pagination Helper](https://github.com/fahmiwol/tyx-lab/tree/main/modules/pagination-helper) (ops): Compute pagination windows (page, total, offset, page links) for lists and APIs.
- [Provider Quota Tracker](https://github.com/fahmiwol/tyx-lab/tree/main/modules/quota-tracker) (ops): Admin-only quota tracking for shared providers (HF, RunPod, OpenAI). Daily/monthly caps, alerts at 70%/90%/100%.
- [Rupiah Currency & Text Formatter](https://github.com/fahmiwol/tyx-lab/tree/main/modules/rupiah-formatter) (ops): Format numbers as IDR currency with short notation (M/jt/rb), and convert to Indonesian words (terbilang).
- [Eval Benchmark Harness](https://github.com/fahmiwol/tyx-lab/tree/main/modules/eval-benchmark-harness) (research): Benchmark model before/after training. Metrics: perplexity, epistemic accuracy, response relevance, sanad coverage, conversation quality (CQF-lite).
- [Knowledge Graph from Wikilinks](https://github.com/fahmiwol/tyx-lab/tree/main/modules/knowledge-graph-wikilinks) (research): Pure TypeScript module to extract and build directed graphs from markdown notes using [[wikilink]] syntax. Backlink indexing, graph visualization data, norma...
- [Infinite Feed Renderer](https://github.com/fahmiwol/tyx-lab/tree/main/modules/infinite-feed-renderer) (video): Vertical infinite scroll feed container with post list and navigation. Decoupled from data source; compose with your own post component.
- [Ken Burns FFmpeg Renderer](https://github.com/fahmiwol/tyx-lab/tree/main/modules/ken-burns-ffmpeg-renderer) (video): Command-line video generation from still images using Ken Burns zoom-pan effect. Chains ffmpeg with zoompan filter for cinematic image→video conversion. Su...
- [Multi-Platform Publisher Adapter](https://github.com/fahmiwol/tyx-lab/tree/main/modules/multi-platform-publisher-adapter) (video): One interface to publish/assist-publish a video to YouTube, TikTok, Instagram, and Facebook.
- [Story Carousel Component](https://github.com/fahmiwol/tyx-lab/tree/main/modules/story-carousel-component) (video): Instagram-style story carousel using compound component pattern. Horizontal scroll with narrative-driven UX. Styled, responsive.
- [YouTube Resumable Upload Wrapper](https://github.com/fahmiwol/tyx-lab/tree/main/modules/youtube-upload-wrapper) (video): Wrap the YouTube Data API for OAuth + resumable uploads with processing/transcript polling.

## Artifacts (methods, frameworks, findings, prompts)

- [Three.js Scene Architecture & Composition Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/threejs-scene-architecture) (3d/method): Reusable Three.js scene patterns: helper functions (box/cyl builders), material/group composition, warp zones for navigation, and rendering optimization. Use...
- [Agent Persona Router](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/agent-persona-router) (ai/method): Dispatch tasks to specialized agent personas with isolated memory.
- [Agent Session Handoff & Continuity Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/agent-session-handoff) (ai/method): Durable handoff pattern for multi-agent coding work: continuity log (AGENT_CONTINUITY.md) tracks every session with ID, date, agent, changes, test results, a...
- [AI Agent Skill Design Principles & Progressive Disclosure](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/skill-design-principles) (ai/playbook): Framework for designing reusable skills for AI agents (Claude, Cursor, OpenCode, Codex). Covers progressive disclosure (metadata → SKILL.md → bundled res...
- [AI Provider Fallback Chain with Circuit Breaker](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/ai-provider-fallback-chain) (ai/method): Graceful degradation pattern for LLM API calls. Primary provider (e.g. Anthropic) fails → fallback to secondary (OpenAI) → tertiary (Mistral/Ollama). Cir...
- [Asbabun Nuzul: Grounded Brief Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/asbabun-nuzul-grounded-brief) (ai/playbook): Every creative output grounded in specific trigger (Asbabun Nuzul). Extract: trigger event, specific audience, concrete moment, real tension. Generic briefs ...
- [Autonomous Growth Flywheel](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/autonomous-growth-flywheel) (ai/framework): Closed-loop architecture for autonomous AI systems: input→process→store→output layers enabling self-improvement without manual training
- [Autonomous Task Lifecycle & State Persistence](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/autonomous-task-lifecycle) (ai/method): State machine pattern for long-running AI tasks: pending → started → running → done/failed. Persist state to JSON + Socket.io events for live UI update...
- [Autonomy System Pre-Flight Checklist](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/autonomy-preflight-checklist) (ai/checklist): Critical reconnaissance checklist before executing tasks in autonomous AI systems to avoid context loss and server/repo confusion.
- [Brief to Storyboard to Video Pipeline](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/brief-to-video-storyboard-pipeline) (ai/playbook): End-to-end methodology for generating short-form video content (20-30 sec) from a brief, featuring Visual DNA consistency, AI storyboard generation, keyframe...
- [Continuous Learning & Self-Evolution: System-Centric Learning Without Catastrophic Forgetting](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/continuous-learning-evolution-methodology) (ai/method): Methodology for enabling AI agents to continuously improve through experience without retraining base model, based on Stability-Plasticity Tradeoff principle.
- [Continuous Learning via Reflective Loop (Tafakkur)](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/continuous-learning-tafakkur) (ai/framework): Self-evolution without catastrophic forgetting: frozen core + dynamic LoRA adapters + episodic memory (error traces) + semantic memory (learned patterns). Ag...
- [Creative Brief Intake Framework (IHOS-Aligned)](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/brief-intake-framework) (ai/template): Structured intake for creative briefs: capture all 4 semantic layers (Zahir/Batin/Hadd/Mathla), user state (Haal), grounding context (Asbabun Nuzul), and val...
- [Embedding / RAG Chunking](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/embedding-rag-chunking) (ai/method): Split documents semantically for RAG with hierarchical metadata.
- [Eval-Gate & Regression-Guard: Model Quality Certification Framework](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/eval-gate-regression-guard) (ai/framework): Automated quality assurance system for SLMs that certifies new models are better than baseline before deployment, preventing regressions via MT-Bench-style e...
- [Hermes Controller — Multi-Agent Orchestration Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/hermes-controller-pattern) (ai/architecture): 2-tier cascade: lightweight controller routes tasks to specialized executors. Each agent has persona + tools + memory. Controller recalls relevant notes, pic...
- [IHOS Epistemology Framework](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/ihos-epistemology-framework) (ai/framework): Islamic Epistemology (Ilmu Jariyah, Hifdz, Akses Umat, Sistem) as applied to AI system design. Translates 1400-year-old validation principles into modern eng...
- [LLM Provider Fallback Router](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/llm-provider-fallback) (ai/method): Route LLM calls across multiple providers with automatic fallback on error or rate limit.
- [LoRA Continual Learning Without Catastrophic Forgetting](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/lora-continual-learning) (ai/method): Methodology for incrementally improving SLMs via LoRA adapters while preserving previously learned knowledge, persona, and safety constraints.
- [Multi-Agent Intent-Based Dispatch Router](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/multi-agent-dispatch-router) (ai/method): Intelligent routing system that detects user intent and dispatches to the best specialized agent. Supports command-based routing, LLM-based intent classifica...
- [Multi-Provider Token & Cost Estimator](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/token-cost-estimator) (ai/method): Estimate token counts and cost across LLM providers with caching.
- [NPC Agent Identity & World-Object Schema: Gaming AI & Interactive Worlds](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/npc-identity-world-schema) (ai/schema): Unified data model for defining NPC identities, world state, and relationships. Supports emergent gameplay where NPCs react based on persistent episodic/sema...
- [Prompt Chain Orchestration](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/prompt-chain-orchestration) (ai/method): Compose multi-step LLM workflows with loops and conditionals.
- [Prompt Version Tracking](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/prompt-version-tracking) (ai/method): System prompt versioning pattern — tag each LLM generation with prompt revision for A/B testing output quality.
- [ReAct Agent Loop (Reason + Act + Observe)](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/react-agent-loop-pattern) (ai/playbook): Reasoning + Action + Observation loop. Agent generates Thought → Action (tool call) → Observation (result) → loops until sufficient info → Final Answ...
- [Repository Cartography & Doc Tier Classification](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/repository-cartography-pattern) (ai/method): Pattern for mapping large multi-document repositories: tier docs by authority (T0 operational source-of-truth through T5 historical), resolve doc conflicts, ...
- [Reputation & Trust Scoring: Multi-Signal Agent Credibility Framework](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/reputation-trust-scoring) (ai/framework): Framework for scoring agent trustworthiness based on multi-dimensional signals (completion rate, quality, fraud likelihood, financial health) to determine pr...
- [SLM Distillation Pipeline: Teacher-Student Recursive Refinement](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/slm-distillation-pipeline) (ai/method): Production-grade methodology for distilling knowledge from larger teachers into smaller SLMs via multi-teacher consensus voting and preference pair collection.
- [SLM Identity Training Guide](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/slm-identity-training-guide) (ai/guide): End-to-end guide for training small language model identity and behavior via SFT and DPO with contamination prevention and eval gates
- [Slm Training Pipeline Patterns](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/slm-training-pipeline-patterns) (ai/method): End-to-end SLM fine-tuning patterns including data curation, LoRA configuration, eval gates, and rollback procedures
- [Visual Workflow Node Schema](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/workflow-node-schema) (ai/framework): A visual-orchestration node contract and execution engine for chaining tools and LLMs.
- [Voice Clone & TTS Playbook](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/voice-clone-tts-playbook) (ai/playbook): End-to-end text-to-speech pipeline: user auth, voice synthesis, caching, credit system, marketplace listing. Reference implementation.
- [Agent-Economy Credit-Minting Design: Service Credits & Internal Currency](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/agent-economy-credit-minting) (business/framework): Framework for designing internal service credit systems that incentivize agent collaboration, prevent abuse, and enable frictionless service exchanges in mul...
- [Brand Identity Framework](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/brand-identity-framework) (business/framework): Aaker 5-slot + Sinek Golden Circle + Neumeier Onlyness positioning framework. Use as strategic validation checklist for generated brand identities.
- [Design System Starter](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/design-system-starter) (business/framework): Comprehensive design system template with color palette, typography scale, component specs, spacing, interactions, responsive guidelines, accessibility stand...
- [Finite State Machine for Workflows](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/finite-state-machine-workflows) (business/framework): Model complex processes (payments, withdrawals, approvals) with explicit states, guarded transitions, side effects, and audit trails. Prevents invalid state ...
- [Money Math in Minor Units](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/money-math-minor-units) (business/formula): Prevent floating-point rounding errors in financial calculations by working entirely in integer minor units (cents, satoshis). Includes conversion, fee calcu...
- [PRD Template & Structure](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/prd-template) (business/template): Comprehensive PRD framework for digital products, covering overview, goals, users, scope, architecture, features, design systems, data models, roles, workflo...
- [Pricing Plans Schema](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/pricing-plans-schema) (business/template): SaaS pricing plan template (free/pro/enterprise with features, pricing, highlights)
- [Reward & Gamification System](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/reward-gamification-system) (business/template): Non-monetary reward system with achievement unlocks, leaderboards, and engagement incentives. Points drive user retention without fintech regulatory burden.
- [Sitemap & Information Architecture Template](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/sitemap-information-architecture) (business/template): Framework for organizing content and navigation structure, covering IA principles, structure patterns, labeling strategy, URL conventions, navigation systems...
- [SLM vs Cloud API: Decision Framework for Model Selection](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/slm-vs-api-decision-framework) (business/framework): Decision framework for choosing between self-hosted SLMs (7B-13B) and cloud APIs based on latency, cost, privacy, customization, and reliability requirements.
- [Tenant Isolation Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/tenant-isolation-pattern) (business/playbook): Multi-tenant architecture via per-user stores + shared admin store
- [Tiered Pricing & Package Resolution](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/tiered-pricing-package-resolution) (business/formula): Dynamic pricing models: fixed packages with bonuses, quantity-based tiers, customer segments, and time-based proration for subscriptions.
- [Transaction Settlement State Machine](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/transaction-settlement-state-machine) (business/artifact): Canonical state flow for settlement workflows: PENDING → AUTHORIZED → POSTED → RECONCILED. Defines valid transitions, error recovery paths (RETURNED, F...
- [Wireframe to Prototype Method](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/wireframe-to-prototype-method) (business/method): Step-by-step methodology for converting wireframes into interactive prototypes, covering component hierarchy, data structure, interaction patterns, responsiv...
- [Lead Source & Bounce Reason Taxonomy](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/lead-source-classifier) (crm/framework): Extensible enum of lead sources (WhatsApp, Referral, Cold Call, etc.) and bounce reasons (price, budget, competitor, etc.). Use for CRM pipeline classification.
- [Connector Base Guard Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/connector-base-guard-pattern) (infra/architecture): Multi-platform integration with automatic guard layers: health check → circadian → rate-limit → think delay → transport. Single source of truth for a...
- [Cost-Aware GPU Training Optimization](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/cost-aware-gpu-training-optimization) (infra/method): Methods for reducing cloud GPU training costs through dependency caching, hardware selection, and pre-built images
- [Credit Metering System: Real-Time Usage Tracking & Enforcement](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/credit-metering-system) (infra/framework): Production system for tracking agent/user service consumption in real-time, enforcing quotas, and preventing over-spend in multi-tenant SaaS and agent market...
- [ERD & Data Model Design Method](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/erd-data-model-design) (infra/method): Structured methodology for designing Entity-Relationship Diagrams and data models for multi-user platforms, covering entity inventory, relationships, attribu...
- [exFAT Windows Fix for Next.js / Webpack](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/exfat-windows-fix) (infra/finding): Fix EISDIR readlink crashes when building Next.js/Webpack projects on a Windows exFAT drive by shimming fs.readlink before webpack captures it.
- [Express API Gateway Response Wrapper Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/api-gateway-pattern) (infra/template): Standardized Express.js gateway pattern: all endpoints return {ok:boolean, data|error:string} JSON structure with try/catch wrapping, logging, and error code...
- [Frontend Deploy Bash Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/frontend-deploy-bash-pattern) (infra/template): Parameterized shell script for zero-downtime frontend deployment: git pull, npm build, PM2 restart, rsync sync, health check verification.
- [Git Workflow — Windows + Private GitHub Repo](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/git-workflow-windows) (infra/playbook): Lean git setup and recovery flow tuned for Windows + a private GitHub repo: PAT auth, conventional commits, Windows path pitfalls, and safe undo.
- [How to Build an MCP Server](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/build-mcp-server) (infra/methodology): Step-by-step guide to authoring a Model Context Protocol server from scratch. Covers architecture, tool definition, registration, testing, deployment, and co...
- [Idempotent Payment Retry Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/idempotent-payment-retry-pattern) (infra/artifact): Reference design for payment retry logic that prevents duplicate charges. Uses idempotency keys (UUID-based), response caching, and state machine for in-flig...
- [Infrastructure Context Mapping](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/infrastructure-context-mapping) (infra/playbook): Method for mapping multi-server, multi-repo projects to prevent execution confusion and ensure correct deployments
- [LLM JSON Repair & Fallback](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/json-repair-fallback) (infra/method): Recover valid JSON from malformed LLM output via repair and partial extraction.
- [Meta Pixel + Conversions API with Dedup](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/meta-capi-dedup) (infra/playbook): Wire Meta Pixel + server-side Conversions API with browser<->server event_id dedup for high Event Match Quality, no CAPI Gateway needed.
- [Next.js + Three.js Deploy & WebGL Debugging Gotchas](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/nextjs-webgl-deploy-gotchas) (infra/finding): Reusable failure modes when deploying a Next.js app with a Three.js/WebGL scene: stale-serve traps and silent GLB/meshopt render failures, with fixes.
- [Next.js Subdomain Multi-Tenant Routing](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/nextjs-subdomain-multitenant) (infra/playbook): Subdomain -> tenant rewriting in Next.js App Router via middleware, with static/verification-file exemptions and localhost fallback.
- [Nginx Security Headers Pattern](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/nginx-security-headers-pattern) (infra/template): Production nginx config snippet for security headers, TLS hardening, compression, cache control, and PWA/Service Worker handling.
- [Resilient Cross-Provider Tool Calling](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/tool-calling-resilient) (infra/method): Cross-provider tool-calling schema with validation and retry.
- [Runpod Gpu Training Pipeline](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/runpod-gpu-training-pipeline) (infra/method): Practical methodology for orchestrating LoRA/DPO training on RunPod cloud GPUs with cost optimization
- [Self-Hosted Model Serving Architecture: Local-First SLM Deployment](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/self-hosted-model-serving) (infra/framework): Production-grade architecture for deploying SLMs on commodity hardware without cloud APIs. Covers inference serving, model versioning, hot-swap deployment, a...
- [API Design & Contract Checklist](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/api-design-checklist) (ops/checklist): Comprehensive checklist for REST API and async API design, covering endpoints, validation, HTTP status codes, auth, security, documentation, testing, version...
- [Disciplined Execution — the 8-gate loop](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/disciplined-execution) (ops/method): A test-driven execution discipline: decompose into epics/episodes and gate every episode through 8 validation steps so regressions never ship.
- [Facebook Business Domain Verification (dual-method)](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/facebook-domain-verification) (ops/playbook): Verify a domain in Meta Business Manager via BOTH meta-tag and HTML-file methods, with a Next.js middleware exemption so verification files serve verbatim.
- [PM2 Ecosystem Config with Feature Flags](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/pm2-feature-flag-ecosystem-config) (ops/template): Multi-process PM2 ecosystem.config.js with environment-based feature flags, cron health checks, mixed interpreter support (bash, node, serve), and A/B testin...
- [RBAC Role/Permission Matrix Template](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/rbac-role-permission-matrix) (ops/template): Role-Based Access Control framework for multi-tier platforms, featuring role hierarchy, permission matrices, field-level masking, role transitions, audit tra...
- [Repository Cartography & Agent Handoff](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/repo-cartography-handoff) (ops/method): Build a maintainable documentation map for a large repo: tiered doc list, folder roles, runtime flow, conflict table, honest coverage, and a living handoff log.
- [Security & Compliance Checklist](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/security-compliance-checklist) (ops/checklist): Comprehensive security hardening and regulatory compliance framework for digital platforms, covering authentication, data protection, infrastructure, logging...
- [Shopee Open Platform — Partner App Integration](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/shopee-open-platform-integration) (ops/playbook): Build a Shopee Partner App: one developer account onboarding many seller shops via OAuth, HMAC-SHA256 signing, token lifecycle, minimum-scope and review stra...
- [Shopee Storefront to Your DB — decision tree](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/shopee-data-import) (ops/playbook): Pragmatic ranked paths to get product data out of a Shopee storefront (CSV export, Meta Catalog API, paid scraper, manual seed) with what fails and why.
- [Dataset Provenance: The Sanad Method (Certification Chain)](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/sanad-dataset-provenance) (research/method): Provenance tracking methodology for training datasets with verifiable chain from source to production, enabling trust auditing, reproducibility, and regulato...
- [Epistemology Reasoning Framework](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/epistemology-reasoning-framework) (research/framework): Structured reasoning with explicit uncertainty and sourcing.
- [Selective Adoption Doctrine](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/selective-adoption-doctrine) (research/method): When studying an external reference (library, competitor, sample repo), adopt the transferable PATTERN only — never import the whole framework.
- [Storyboard Prompt Variants](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/storyboard-prompt-variants) (video/template): Generate multi-genre video-generation prompts (ads, cinematic, generic) from a storyboard.

## Recipes

- [ai-content-pipeline](https://github.com/fahmiwol/tyx-lab/tree/main/recipes/ai-content-pipeline.md)
- [brand-system-builder](https://github.com/fahmiwol/tyx-lab/tree/main/recipes/brand-system-builder.md)
- [fintech-wallet-and-minting](https://github.com/fahmiwol/tyx-lab/tree/main/recipes/fintech-wallet-and-minting.md)
- [rag-knowledge-base](https://github.com/fahmiwol/tyx-lab/tree/main/recipes/rag-knowledge-base.md)
- [self-hosted-agent-stack](https://github.com/fahmiwol/tyx-lab/tree/main/recipes/self-hosted-agent-stack.md)
- [ship-an-mcp-server](https://github.com/fahmiwol/tyx-lab/tree/main/recipes/ship-an-mcp-server.md)
- [tracked-multitenant-saas](https://github.com/fahmiwol/tyx-lab/tree/main/recipes/tracked-multitenant-saas.md)

- [Local GPU Bridge — Borrow the Owner's Consumer GPU (Inference, Image-Gen, Training)](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/local-gpu-bridge) (infra/method): Reverse-SSH bridge so an always-on CPU server borrows a consumer GPU at home: restricted tunnel-only user, one-script installer, antifragile failover, local image-gen via sd-server, WDDM commit trap, local-training pattern.
- [Small-Model Backbone Design — Intelligence from the System, Not the Weights](https://github.com/fahmiwol/tyx-lab/tree/main/artifacts/small-model-backbone) (ai/framework): Make a 4B-8B model behave like a much larger one via a 17-facility backbone: quality formula, facility catalog, 3-point output discipline, biggest-impact-first rollout.
- [Reasoning Bank — Read-Path Strategy Memory](https://github.com/fahmiwol/tyx-lab/tree/main/modules/reasoning-bank) (ai/module): Learn from failures with zero retraining — strategies mined from user corrections, retrieved by intent + token overlap, injected into the prompt.

## Machine access
- index.json: https://raw.githubusercontent.com/fahmiwol/tyx-lab/main/index.json
- MCP server (search_atoms/get_atom/list_categories): tools/tyx-lab-mcp