zaileys 3.1.0 → 3.2.0

package/.kelar/memory/INDEX.md

@@ -1,21 +0,0 @@
-# KELAR Knowledge Index
-Last updated: 2026-03-24
-
-
-## Domain
-*(none yet)*
-
-## Technical
-- **Issue #34: sendPresenceUpdate undefined** — Issue #34: sendPresenceUpdate undefined Root cause: centerStore had a 10m TTL ca
-- **LMDB Native Binary Fallback** — LMDB Native Binary Fallback Resolved a hard crash where LMDBAdapter would fail o
-- **NeDBAdapter ignoring encoder causes Buffer typing crash (ERR_INVALID_ARG_TYPE)** — NeDBAdapter ignoring encoder causes Buffer typing crash (ERR_INVALID_ARG_TYPE) W
-- **Signal media constructor input contract** — Signal media constructor input contract Media constructor expects raw MediaInput
-- **Sticker example source format** — Sticker example source format Picsum sticker endpoint can return unsupported ada
-- **TS2307 missing @seald-io/nedb** — TS2307 missing @seald-io/nedb Fix: add @seald-io/nedb to root dependencies; tsc 
-- **TS2307: Missing @zaileys/store-adapters** — TS2307: Missing @zaileys/store-adapters After removing @zaileys/store-adapters p
-
-## Solutions
-*(none yet)*
-
-## Environment
-*(none yet)*

package/.kelar/memory/technical/issue-34-sendpresenceupdate-undefined.md

@@ -1,4 +0,0 @@
-## Issue #34: sendPresenceUpdate undefined
-Added: 2026-03-22
-
-Issue #34: sendPresenceUpdate undefined Root cause: centerStore had a 10m TTL causing socket reference loss. Solution: Removed TTL for critical namespaces and added safety checks in Signal class.

package/.kelar/memory/technical/lmdb-native-binary-fallback.md

@@ -1,4 +0,0 @@
-## LMDB Native Binary Fallback
-Added: 2026-03-22
-
-LMDB Native Binary Fallback Resolved a hard crash where LMDBAdapter would fail on platforms without compatible native binaries (e.g. Darwin ARM64) even if the package was installed. Implemented a try-catch fallback in getOrOpenDB to automatically switch to JSONAdapter when initialization fails.

package/.kelar/memory/technical/nedbadapter-ignoring-encoder-causes-buffer-typing-crash-err-invalid-arg-type.md

@@ -1,4 +0,0 @@
-## NeDBAdapter ignoring encoder causes Buffer typing crash (ERR_INVALID_ARG_TYPE)
-Added: 2026-03-24
-
-NeDBAdapter ignoring encoder causes Buffer typing crash (ERR_INVALID_ARG_TYPE) When switching from LMDBAdapter to NeDBAdapter, the encoder wrapper was ignored. This caused Baileys auth state which is populated with Buffer structures to load as generic JSON objects from disk, resulting in fatal unhandled crashes when passing those objects to the crypto library. Fixed by checking options.encoder and applying it during set/get loops inside NeDBAdapter.

package/.kelar/memory/technical/signal-media-constructor-input-contract.md

@@ -1,4 +0,0 @@
-## Signal media constructor input contract
-Added: 2026-03-24
-
-Signal media constructor input contract Media constructor expects raw MediaInput (string/Buffer/ArrayBuffer), not keyed objects like {sticker: ...}. Passing keyed objects can trigger unsupported format failures during sticker processing.

package/.kelar/memory/technical/sticker-example-source-format.md

@@ -1,4 +0,0 @@
-## Sticker example source format
-Added: 2026-03-24
-
-Sticker example source format Picsum sticker endpoint can return unsupported adaptive image formats for sticker conversion. Use a deterministic PNG/JPEG source URL in examples to prevent runtime sticker creation failures.

package/.kelar/memory/technical/ts2307-missing-seald-io-nedb.md

@@ -1,4 +0,0 @@
-## TS2307 missing @seald-io/nedb
-Added: 2026-03-24
-
-TS2307 missing @seald-io/nedb Fix: add @seald-io/nedb to root dependencies; tsc noEmit returns exit 0.

package/.kelar/memory/technical/ts2307-missing-zaileys-store-adapters.md

@@ -1,4 +0,0 @@
-## TS2307: Missing @zaileys/store-adapters
-Added: 2026-03-23
-
-TS2307: Missing @zaileys/store-adapters After removing @zaileys/store-adapters package, legacy imports in src/Config/database.ts and src/Classes/client.ts must be updated to src/Types/store.ts (IStoreAdapter) and src/Library/nedb.ts (NeDBAdapter).

package/.kelar/plans/README.md

@@ -1,3 +0,0 @@
-# .kelar/plans/
-
-Auto-generated by KELAR agents. Not committed to git.

package/.kelar/research/README.md

@@ -1,3 +0,0 @@
-# .kelar/research/
-
-Auto-generated by KELAR agents. Not committed to git.

package/.kelar/research/mysql-adapter-research.md

@@ -1,32 +0,0 @@
-# MySQL Adapter Research Findings
-
-## 🛠️ Technology Stack
-- **Driver**: `mysql2/promise` (Fastest, Promise-based).
-- **Pooling**: Use `mysql2.createPool` with a sensible limit (e.g., 10-20 connections).
-- **Concurrency**: `async-mutex` for thread-safe batching.
-
-## 📊 Schema Design
-```sql
-CREATE TABLE IF NOT EXISTS `zaileys_store` (
-  `id` VARCHAR(255) PRIMARY KEY,
-  `data` JSON NOT NULL,
-  `updatedAt` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
-);
-```
-
-## 🚀 Performance Strategy: Write-Behind Batching
-Baileys can trigger thousands of writes. We will implement a "Write-Behind" strategy:
-1. **Accumulate**: Changes are stored in a local `Map`.
-2. **Debounce/Interval**: Every 500ms-1000ms, the `Map` is flushed to MySQL.
-3. **Bulk Upsert**:
-   ```sql
-   INSERT INTO zaileys_store (id, data) 
-   VALUES ? 
-   ON DUPLICATE KEY UPDATE data = VALUES(data)
-   ```
-   *Note: `VALUES` array format: `[[id1, data1], [id2, data2], ...]`*
-
-## ⚠️ Gotchas
-- **Max Packet Size**: Batch chunks should be limited to ~500 rows to avoid `max_allowed_packet` errors.
-- **Connection Loss**: Need to handle pool reconnections automatically.
-- **Data Integrity**: Ensure the flush happens on process exit.

package/.kelar/state/ASSUMPTIONS.md

@@ -1,14 +0,0 @@
-# KELAR Assumption Log
-> Every assumption AI makes is logged here until verified.
-Last updated: 2026-03-22
-
-## Active (Unverified)
-> None yet.
-
-## Verified
-| Date | Assumption | Verified As |
-|------|------------|-------------|
-
-## Corrected
-| Date | Original | Actual | Impact |
-|------|----------|--------|--------|

package/.kelar/state/DEBT.md

@@ -1,13 +0,0 @@
-# Technical Debt & Anti-Patterns: Zaileys
-
-## 🚨 Critical Items
-- **Missing Dev Script Target**: `package.json` references `examples/test.ts` in the `dev` script, but the file is missing in the repository. (Found: `examples/basic.ts` exists instead).
-- **Loose Type Safety in Store**: `centerStore.get('socket')` and similar calls rely on manual casting (e.g., `as any`). A typed store wrapper or bridge would be safer.
-
-## ⚠️ Improvements
-- **Registry Visibility**: `UnifiedStore` snapshot exports full records, which might become large. Consider partial snapshots or debugging-only exports.
-- **FireForget Error Handling**: Default error handler only logs to console. Could benefit from a more centralized logging integration with `pino`.
-- **Plugin HMR Scope**: HMR might cause side effects if plugins register global event listeners without cleanup logic.
-
-## 🧹 Maintenance
-- **Documentation**: README is very large but could use a separate `ARCHITECTURE.md` to offload some technical details.

package/.kelar/state/DIARY.md

@@ -1,15 +0,0 @@
-# KELAR Session Diary
-> Auto-written on /kelar:pause. Append-only.
-Last updated: 2026-03-22
-
-## Entry Format
-```
-## [Date] [Time]
-Worked on: [feature/fix]
-Completed: [bullet list]
-Decisions: [pattern decisions → PATTERNS.md]
-Debt     : [DEBT.md additions]
-Next     : [exact next task]
-```
-
-> Sessions will appear here.

package/.kelar/state/HANDOFF.md

@@ -1,54 +0,0 @@
-# KELAR HANDOFF
-Generated: 2026-03-24 23:05:57
-
-## Status
-Feature   : Working on nothing
-Next step : Check TASKS.md
-
-## Recent Activity
-```
-[2026-03-22 18:30:51] ✅ done Fixed 3 compilation errors
-[2026-03-22 18:30:57] ✅ done Verified all compilation errors are fixed
-
-## [2026-03-22 18:31:07] FIX COMPLETE ✅: fix_done src/Classes/client.ts & src/Store/Adapters/nedb.ts — fixed: internal imports and missing dependency
-[2026-03-22 18:31:19] ✅ done Moved nedb.ts to src/Library
-[2026-03-22 18:34:48] ✅ done Fixed all compilation errors after NeDB relocation
-
-## [2026-03-23 11:54:42] FIX STARTED: fix_start TS2307: Cannot find module @zaileys/store-adapters
-
-## [2026-03-23 11:56:05] TASK STARTED
-start Task: Fixing legacy @zaileys/store-adapters imports | Files: src/Config/database.ts, src/Classes/client.ts
-
-## [2026-03-23 11:56:35] FIX COMPLETE ✅: fix_done TS2307: Missing @zaileys/store-adapters — fixed by updating legacy imports to point to local core files
-
-## [2026-03-24 07:22:18] FIX STARTED: fix_start The data argument must be of type string or an instance of Buffer
-
-## [2026-03-24 07:32:06] FIX COMPLETE ✅: fix_done The data argument must be of type string or an instance of Buffer — fixed: NeDBAdapter properly utilizes encoder to serialize and revive Baileys Buffer objects
-
-## [2026-03-24 08:44:18] FIX STARTED: fix_start Sticker creation failed unsupported image format
-
-## [2026-03-24 15:52:46] TASK STARTED
-start Task: Fix TS2307 missing @seald-io/nedb | Files: package.json,pnpm-lock.yaml
-[2026-03-24 15:53:26] ✅ done Task: Fixed TS2307 by adding @seald-io/nedb dependency; bun tsc --noEmit passes
-
-## [2026-03-24 16:04:08] TASK STARTED
-start Task: Fix sticker input buffer format crash | Files: src/Signal/index.ts, src/Classes/client.ts, src/Listener/connection.ts
-[2026-03-24 16:06:02] ✅ done Task: Fixed sticker crash by switching example sticker media source to deterministic PNG URL
-
-## [2026-03-24 16:09:22] TASK STARTED
-start Task: Root fix sticker unsupported format in Signal flow | Files: src/Signal/index.ts
-[2026-03-24 16:09:57] ✅ done Task: Fixed Signal media branches to pass raw inputs to Media constructor
-[2026-03-24 16:52:07] ✅ done Task: Removed debug instrumentation from Signal sticker flow after confirmed fix
-
-## [2026-03-24 23:04:01] FEATURE STARTED: feature_start clean-logging
-
-## [2026-03-24 23:04:52] TASK STARTED
-start Task: 1 | Files: src/Classes/logs.ts
-[2026-03-24 23:05:54] ✅ done Task 1: Updated logs.ts format to be more intuitive
-
-## [2026-03-24 23:05:57] FEATURE COMPLETE ✅: feature_done Clean Logging System — Completed refactoring
-```
-
-## Resume
-1. Run /kelar:resume
-2. Confirm next step

package/.kelar/state/PATTERNS.md

@@ -1,43 +0,0 @@
-# Approved Patterns: Zaileys
-
-## 1. Registry Pattern (Unified Store)
-All memory-resident state should be managed via the `store` singleton.
-```typescript
-import { store } from '../Store';
-const myStore = store.ns('my-feature');
-myStore.set('key', value);
-```
-
-## 2. Prioritized Background Tasks
-Use the `fireForget` engine for tasks that shouldn't block the main event loop.
-```typescript
-import { fireForget, Priority } from '../Library/fire-forget';
-fireForget.add(async () => {
-  // task logic
-}, { priority: Priority.HIGH });
-```
-
-## 3. Class Injection (Proxy)
-Extend Client functionality by injecting specialized classes rather than huge inheritance chains.
-```typescript
-// In Client constructor
-const proxy = classInjection(this, [
-  new NewFeature(this),
-]);
-```
-
-## 4. Input Validation
-Use `valibot` for all public-facing configurations.
-```typescript
-import * as v from 'valibot';
-const Schema = v.object({...});
-const data = parseValibot(Schema, input);
-```
-
-## 5. Event Handling
-Emit and listen to events via `store.events`.
-```typescript
-store.events.on('event-name', (data) => {
-  // handler
-});
-```

package/.kelar/state/STATE.md

@@ -1,37 +0,0 @@
-# Project State: Zaileys
-
-## 🏗️ Architecture
-Zaileys is a high-level, type-safe wrapper for the Baileys WhatsApp library. It follows a layered, modular architecture focused on performance and developer experience.
-
-### Core Components
-- **Client (src/Classes/client.ts)**: The main entry point. Uses a `class-proxy` to combine multiple specialized classes (`Signal`, `SignalGroup`, `SignalPrivacy`, etc.) into a single interface.
-- **Unified Store (src/Store/unified-store.ts)**: Implements a Registry Pattern. Provides namespaced memory stores using `LRUCache` for efficiency and `async-mutex` for thread safety.
-- **Fire & Forget (src/Library/fire-forget.ts)**: A prioritized task execution engine. Handles background operations with configurable concurrency, timeouts, and retries.
-- **Plugin System (src/Classes/plugins.ts)**: Automatically loads plugins from a directory with Hot Module Replacement (HMR) support.
-- **Middleware (src/Classes/middleware.ts)**: Allows intercepting and processing events globally.
-
-### Data Flow
-1. **Events**: WhatsApp socket events are received by `Listener`.
-2. **Context**: Events are wrapped into a rich `Context` object.
-3. **Execution**: Handlers (listeners or plugins) are executed, often utilizing `fireForget` for non-blocking actions.
-4. **Storage**: Persistent data (sessions, chats) is stored in `LMDB` via `Store` modules.
-
-## 🛠️ Stack
-- **Runtime**: Node.js (v20+)
-- **Language**: TypeScript (v5+)
-- **Base Library**: `baileys` (v7)
-- **Database**: `lmdb`
-- **Validation**: `valibot`
-- **Utilities**: `radashi`, `gradient-string`, `figlet`, `nanospinner`
-- **Logging**: `pino`
-- **Build Tool**: `tsup`
-- **Package Manager**: `pnpm`
-
-## 📏 Conventions
-- **Validation**: Always use `valibot` for external inputs or configuration.
-- **Async Safety**: Use `async-mutex` for operations modifying shared state in `UnifiedStore`.
-- **Background Work**: Wrap long-running or non-critical operations in `fireForget.add()`.
-- **Namespacing**: Use the `store.ns(name)` pattern for all internal state.
-- **Type Safety**: Prefer `v.InferOutput` for working with validated schemas.
-
-Working on: Working on nothing

package/.kelar/state/TASKS.md

@@ -1,146 +0,0 @@
-# KELAR Tasks
-> Micro-task tracker. Updated after every completed task.
-Last updated: 2026-03-22
-
-## Active
-None
-
-## Micro-Tasks
-> Populated during /kelar:feature or /kelar:fix
-
-## Completed (append-only)
-> [x] [timestamp] [task] — DONE
-
-
-## [2026-03-22 02:52:24] TASK STARTED
-start Task: /kelar:map | Files: .kelar/state/STATE.md, .kelar/state/PATTERNS.md, .kelar/state/DEBT.md, .kelar/memory/INDEX.md
-[2026-03-22 02:53:33] ✅ done Mapped codebase: Identified Registry pattern, Fire-Forget engine, and Client proxy architecture. Found debt in examples/test.ts.
-
-## [2026-03-22 02:57:59] TASK STARTED
-start Task: /kelar:feature | Feature: dev test file | Files: examples/test.ts
-[2026-03-22 03:00:05] ✅ done Restored examples/test.ts for dev script.
-
-## [2026-03-22 12:19:16] FIX STARTED: fix_start Issue #34: sendPresenceUpdate undefined after 10m idle
-
-## [2026-03-22 12:20:40] FIX COMPLETE ✅: fix_done Issue #34 fixed by removing TTL from center/context stores and adding defensive checks.
-
-## [2026-03-22 12:30:55] FIX STARTED: fix_start Finalizing sharp silent fallback
-
-## [2026-03-22 12:31:44] FIX COMPLETE ✅: fix_done Issue #35: Sharp fallback implemented for Termux compatibility.
-
-## [2026-03-22 12:40:05] FEATURE STARTED: feature_start Researching LMDB Android/Termux compatibility and fallback
-
-## [2026-03-22 12:57:52] TASK STARTED
-start Task: Removing explicit adapter option | Files: src/Types/client.ts, src/Config/database.ts, src/Classes/client.ts, src/Auth/state.ts, src/Auth/creds.ts
-[2026-03-22 12:58:30] ✅ done Simplified storage system: removed explicit adapter option, made it fully automated via database.ts
-[2026-03-22 12:58:39] ✅ done Storage system: fully automated LMDB/JSON selection integrated
-[2026-03-22 13:02:34] ✅ done Hardened JSONAdapter: fixed case-sensitivity and atomic write loopholes via hex-sharding
-
-## [2026-03-22 13:05:18] TASK STARTED
-start Task: Removing package-lock.json from store-adapters | Files: store-adapters/package-lock.json
-[2026-03-22 13:05:32] ✅ done Removed package-lock.json from store-adapters
-
-## [2026-03-22 13:06:37] TASK STARTED
-start Task: Migrating from @zaadevofc/media-process to @zaileys/media-process | Files: all
-[2026-03-22 13:09:24] ✅ done Migrated to local @zaileys/media-process link and verified build
-[2026-03-22 13:11:38] ✅ done Final build success after full migration
-
-## [2026-03-22 13:12:33] TASK STARTED
-start Task: Type checking with tsc --noEmit | Files: all
-[2026-03-22 13:15:02] ✅ done All TypeScript errors resolved. Project is clean.
-
-## [2026-03-22 13:16:03] TASK STARTED
-start Task: Final Fix for Media process imports | Files: All affected
-[2026-03-22 13:16:17] ✅ done All imports verified and clean
-[2026-03-22 13:18:13] ✅ done Final verification success
-[2026-03-22 13:19:41] ✅ done Stress test v2 passed successfully
-[2026-03-22 13:24:04] ✅ done Stress test verified visually and cleaned up
-[2026-03-22 13:27:57] ✅ done Package lock updated and verified
-
-## [2026-03-22 13:30:09] TASK STARTED
-start Task: Auditing package.json | Files: package.json
-[2026-03-22 13:33:34] ✅ done Stress test verified visually and permanently cleaned up
-
-## [2026-03-22 14:45:47] TASK STARTED
-start Task: Swapping local links for official npm packages | Files: package.json
-[2026-03-22 14:46:14] ✅ done Successfully migrated to official npm packages
-[2026-03-22 16:07:18] ✅ done Fixed LMDB initialization crash with automated JSON fallback
-
-## [2026-03-22 16:08:37] FIX STARTED: fix_start LMDB Crash Persistent Regression
-[2026-03-22 16:09:03] ✅ done Restored database.ts fallback
-
-## [2026-03-22 16:14:03] FEATURE STARTED: feature_start Rework: Pure JSON High-Performance Storage
-[2026-03-22 16:26:53] ✅ done Linked store-adapters locally
-[2026-03-22 16:27:22] ✅ done Completed storage rework to NeDB
-[2026-03-22 16:29:05] ✅ done Locked database.ts to NeDB
-[2026-03-22 16:33:40] ✅ done Completed Stress Testing and Optimization
-[2026-03-22 16:54:19] ✅ done Cancelled SessionResilience service
-[2026-03-22 16:54:37] ✅ done Restored build stability after SessionResilience removal
-[2026-03-22 16:55:24] ✅ done Final verification successful. Mutex performance confirmed.
-[2026-03-22 16:56:39] ✅ done Verified intense update resilience with Mutex
-[2026-03-22 16:57:56] ✅ done Passed strategic complexity test with mixed ops and compaction
-
-## [2026-03-22 17:09:44] FEATURE STARTED: feature_start Multi-Database Support (MySQL/Redis/Sequelize)
-
-## [2026-03-22 17:33:01] FIX STARTED: fix_start Fix messy monorepo structure in Library folder
-[2026-03-22 17:41:39] ✅ done Cleaned up old root files
-
-## [2026-03-22 17:41:59] FIX COMPLETE ✅: fix_done Reorganized workspace to Zaileys-centric layout
-
-## [2026-03-22 17:46:21] FIX STARTED: fix_start Fix 'changeset not found' error after workspace reorganization
-[2026-03-22 17:46:48] ✅ done Installed dependencies in new root
-[2026-03-22 17:47:04] ✅ done Verified changeset command
-[2026-03-22 18:00:46] ✅ done Moved .changeset and .github into zaileys root
-[2026-03-22 18:00:55] ✅ done Verified changeset is now found
-
-## [2026-03-22 18:13:26] FEATURE STARTED: feature_start Simplify: Move NeDB to core and remove store-adapters package
-[2026-03-22 18:19:25] ✅ done Migrated NeDB files to core
-[2026-03-22 18:20:01] ✅ done Consolidated storage and removed store-adapters package
-
-## [2026-03-22 18:20:16] FEATURE STARTED: feature_start MySQL Adapter (@zaileys/mysql-adapter)
-[2026-03-22 18:23:10] ✅ done Scaffolded mysql-adapter directory
-[2026-03-22 18:24:45] ✅ done Fixed types and built MySQL adapter
-
-## [2026-03-22 18:25:04] FEATURE COMPLETE ✅: feature_done MySQL Adapter (@zaileys/mysql-adapter) — Built with Write-Behind Batching
-
-## [2026-03-22 18:30:04] FIX STARTED: fix_start Fix 3 compilation errors after storage consolidation
-[2026-03-22 18:30:51] ✅ done Fixed 3 compilation errors
-[2026-03-22 18:30:57] ✅ done Verified all compilation errors are fixed
-
-## [2026-03-22 18:31:07] FIX COMPLETE ✅: fix_done src/Classes/client.ts & src/Store/Adapters/nedb.ts — fixed: internal imports and missing dependency
-[2026-03-22 18:31:19] ✅ done Moved nedb.ts to src/Library
-[2026-03-22 18:34:48] ✅ done Fixed all compilation errors after NeDB relocation
-
-## [2026-03-23 11:54:42] FIX STARTED: fix_start TS2307: Cannot find module @zaileys/store-adapters
-
-## [2026-03-23 11:56:05] TASK STARTED
-start Task: Fixing legacy @zaileys/store-adapters imports | Files: src/Config/database.ts, src/Classes/client.ts
-
-## [2026-03-23 11:56:35] FIX COMPLETE ✅: fix_done TS2307: Missing @zaileys/store-adapters — fixed by updating legacy imports to point to local core files
-
-## [2026-03-24 07:22:18] FIX STARTED: fix_start The data argument must be of type string or an instance of Buffer
-
-## [2026-03-24 07:32:06] FIX COMPLETE ✅: fix_done The data argument must be of type string or an instance of Buffer — fixed: NeDBAdapter properly utilizes encoder to serialize and revive Baileys Buffer objects
-
-## [2026-03-24 08:44:18] FIX STARTED: fix_start Sticker creation failed unsupported image format
-
-## [2026-03-24 15:52:46] TASK STARTED
-start Task: Fix TS2307 missing @seald-io/nedb | Files: package.json,pnpm-lock.yaml
-[2026-03-24 15:53:26] ✅ done Task: Fixed TS2307 by adding @seald-io/nedb dependency; bun tsc --noEmit passes
-
-## [2026-03-24 16:04:08] TASK STARTED
-start Task: Fix sticker input buffer format crash | Files: src/Signal/index.ts, src/Classes/client.ts, src/Listener/connection.ts
-[2026-03-24 16:06:02] ✅ done Task: Fixed sticker crash by switching example sticker media source to deterministic PNG URL
-
-## [2026-03-24 16:09:22] TASK STARTED
-start Task: Root fix sticker unsupported format in Signal flow | Files: src/Signal/index.ts
-[2026-03-24 16:09:57] ✅ done Task: Fixed Signal media branches to pass raw inputs to Media constructor
-[2026-03-24 16:52:07] ✅ done Task: Removed debug instrumentation from Signal sticker flow after confirmed fix
-
-## [2026-03-24 23:04:01] FEATURE STARTED: feature_start clean-logging
-
-## [2026-03-24 23:04:52] TASK STARTED
-start Task: 1 | Files: src/Classes/logs.ts
-[2026-03-24 23:05:54] ✅ done Task 1: Updated logs.ts format to be more intuitive
-
-## [2026-03-24 23:05:57] FEATURE COMPLETE ✅: feature_done Clean Logging System — Completed refactoring

package/AGENTS.md

@@ -1,108 +0,0 @@
-# AGENTS.md
-> Universal agent config. Read by all AI tools.
-> Agent-specific: CLAUDE.md · GEMINI.md
-
----
-
-## 🧠 IDENTITY
-
-You are a senior developer in the **KELAR multi-agent execution framework**.
-Methodical. Research-first. Never improvises patterns — scans first.
-Plans before coding. Logs everything. Verifies after executing.
-
----
-
-## 🛠 KELAR TOOLS — USE THESE ALWAYS
-
-KELAR has a CLI utility at `.kelar/kelar-tools.cjs`. **Use it instead of raw bash for all state operations.**
-
-```bash
-# Session start — ALWAYS run at start of every session
-node .kelar/kelar-tools.cjs health
-node .kelar/kelar-tools.cjs state snapshot
-node .kelar/kelar-tools.cjs handoff read
-node .kelar/kelar-tools.cjs memory search "[current topic]"
-
-# Task logging — ALWAYS log actions
-node .kelar/kelar-tools.cjs tasks log start "Task: [name] | Files: [list]"
-node .kelar/kelar-tools.cjs tasks log done "Task [id]: [what was done]"
-node .kelar/kelar-tools.cjs tasks log pause "[task id]" "[exact next step]"
-
-# Memory — save discoveries
-node .kelar/kelar-tools.cjs memory save technical "[title]" "[content]"
-node .kelar/kelar-tools.cjs memory search "[query]"
-
-# Git — use tools not raw git for consistency
-node .kelar/kelar-tools.cjs git status
-node .kelar/kelar-tools.cjs git commit "feat(kelar): [message]"
-node .kelar/kelar-tools.cjs git checkpoint
-
-# Debt — log out-of-scope issues
-node .kelar/kelar-tools.cjs debt add "[file]" "[issue]" "MEDIUM"
-
-# Patterns — check before inventing
-node .kelar/kelar-tools.cjs patterns get "[category]"
-node .kelar/kelar-tools.cjs patterns set "[category]" "[pattern]"
-
-# Plan operations — for agents working with XML plans
-node .kelar/kelar-tools.cjs plan validate .kelar/plans/[name]-plan.xml
-node .kelar/kelar-tools.cjs plan wave .kelar/plans/[name]-plan.xml 1
-```
-
----
-
-## 🤖 AGENT SYSTEM
-
-Specialized sub-agents spawned via `Task()`:
-
-| Agent | Role |
-|-------|------|
-| `kelar-planner` | XML task plans |
-| `kelar-executor` | Task implementation |
-| `kelar-researcher` | Domain + codebase research |
-| `kelar-plan-checker` | Plan validation |
-| `kelar-verifier` | Goal verification |
-| `kelar-debugger` | Root cause analysis |
-| `kelar-repair` | Autonomous failure recovery |
-| `kelar-ui-designer` | UI design contracts |
-| `kelar-codebase-mapper` | Architecture analysis |
-
-**Every agent must:**
-1. Run `node .kelar/kelar-tools.cjs health` on start
-2. Read all files in its `<files_to_read>` block
-3. Log start/end with kelar-tools tasks log
-4. Save any new knowledge with kelar-tools memory save
-
----
-
-## ⚡ MCP SERVERS
-
-Scan at session start. Use proactively — don't ask, just use.
-If an MCP server exists for the task, use it. Always.
-
----
-
-## 🚫 HARD RULES
-
-1. No hardcoded values
-2. No scope creep → `node .kelar/kelar-tools.cjs debt add`
-3. No silent assumptions → ask one specific question
-4. No symptom patching → root cause first
-5. No code before plan → plan → approve → execute
-6. No task complete without verify
-7. No session without `kelar-tools health` check first
-
----
-
-## ✅ COMPLETION FORMAT
-
-```
-KELAR TASK COMPLETE
-────────────────────
-Done     : [task]
-Files    : [list with summaries]
-Result   : [what user can now do]
-Agents   : [which agents ran]
-Quality  : [gates passed / issues]
-Next     : [suggestion]
-```

package/CHANGELOG.md

@@ -1,12 +0,0 @@
-# zaileys
-
-## 3.1.0
-
-### Minor Changes
-
-- 62a34dc: optimize for linux & android
-
-### Patch Changes
-
-- Updated dependencies [62a34dc]
-  - @zaileys/media-process@2.3.0

package/GEMINI.md

@@ -1,58 +0,0 @@
-# GEMINI.md
-> Antigravity (Gemini CLI) specific configuration. Supplements AGENTS.md.
-> Priority: This file > AGENTS.md (Antigravity reads both, this wins on conflicts)
-
----
-
-## KELAR FRAMEWORK ACTIVE
-
-You are operating under the KELAR execution framework.
-Read AGENTS.md for universal rules. This file contains Antigravity-specific additions only.
-
----
-
-## ANTIGRAVITY-SPECIFIC RULES
-
-### Loading AGENTS.md (Critical Fix for pre-v1.20.3)
-If Antigravity is older than v1.20.3, AGENTS.md won't auto-load.
-In that case, treat this file as the primary rules file AND read AGENTS.md manually
-by looking for it in the project workspace.
-
-Instruction: Check for the presence of AGENTS.md in the project workspace.
-There may be additional AGENTS.md in sub-folders with specific instructions.
-Apply all rules found in AGENTS.md as if they were written here.
-
-### Skills location
-`.gemini/skills/` (symlinked from `.kelar/skills/`)
-
-### Workflows location
-`.gemini/workflows/` (symlinked from `.kelar/workflows/`)
-
----
-
-## ANTIGRAVITY MULTI-AGENT NOTES
-
-When spawning sub-agents:
-- Each sub-agent must also read AGENTS.md on start
-- Pass current TASKS.md state to sub-agents
-- Sub-agent results must be logged back to TASKS.md
-
----
-
-## KNOWLEDGE ITEMS
-
-When discovering reusable knowledge during a session:
-- Save to Antigravity Knowledge Items AND to `.kelar/memory/[topic].md`
-- This ensures knowledge persists even outside Antigravity
-
----
-
-## AUTO-CONTINUE SAFETY GUARDS
-
-Auto-continue is enabled by default in Antigravity v1.20.3+.
-ALWAYS pause and ask before:
-- Writing to database
-- Deleting files
-- Deploying to production
-- Running destructive commands
-- Modifying files outside declared scope

package/packages/media-process/CHANGELOG.md

@@ -1,7 +0,0 @@
-# @zaileys/media-process
-
-## 2.3.0
-
-### Minor Changes
-
-- 62a34dc: optimize for linux & android

package/packages/media-process/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 zaadevofc
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.