feat(project-tracker): add projects and tasks modules with comprehensive hooks, permissions, and validation

- Introduced projects.data.yml and tasks.data.yml for initial data setup.
- Created projects.hook.ts implementing various hooks for data validation, state transitions, and notifications.
- Defined projects.object.yml and tasks.object.yml for schema definitions including fields and actions.
- Established projects.permission.yml and tasks.permission.yml for detailed access control rules.
- Implemented projects.validation.yml for validation rules ensuring data integrity.
- Added types for Projects and Tasks in TypeScript for type safety.
- Configured tsconfig.json for TypeScript compilation settings.

Author: hotlong

.vscode/tasks.json

@@ -2,14 +2,12 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "label": "Run Studio: Basic Script",
+      "label": "Run Dev Server",
       "type": "shell",
-      "command": "node",
+      "command": "pnpm",
       "args": [
-        "packages/cli/dist/index.js",
-        "studio",
-        "--dir",
-        "examples/starters/basic-script"
+        "objectql",
+        "dev"
       ],
       "group": "test",
       "presentation": {

docs/guide/configuration.md

@@ -11,8 +11,8 @@ import { ObjectQL } from '@objectql/core';
 export const db = new ObjectQL({
     connection: 'sqlite://data.db', // 1. Infrastructure
     modules: [
-         '@objectql/starter-basic', // 2. External Module (NPM)
-         './src/modules/billing'    // 3. Local Module
+         '@my-org/module-crm',    // 2. External Module (NPM)
+         './src/modules/billing'  // 3. Local Module
     ],
     // source: ... (Deprecated, use modules)
     plugins: [] // 4. Extensions

docs/guide/getting-started.md

@@ -86,7 +86,7 @@ async function main() {
         // Load schema from local directories OR npm packages
         modules: [
             'src/objects',           // Local Module
-            '@objectql/starter-auth' // External Module (NPM)
+            '@objectql/module-auth'  // External Module (NPM)
         ]
     });
 

examples/README.md

@@ -1,69 +1,77 @@
-# ObjectQL Examples Gallery
+# ObjectQL Examples
 
-Welcome to the ObjectQL examples collection. This directory is organized to help you find the right starting point for your needs, from simple scripts to complex real-world applications.
+Welcome to the ObjectQL Examples repository. This collection demonstrates everything from "Hello World" scripts to complex, module-driven enterprise architectures.
 
-## 📚 Quick References
+## 📂 Directory Structure
 
-| Resource | Description |
-| :--- | :--- |
-| **[Attachment Upload Demo](./attachment-upload-demo.md)** | Complete guide to uploading files, handling images, creating records with attachments, and implementing file upload components |
-
-## 🌐 Browser Demos
-*ObjectQL running directly in web browsers - no backend required!*
+### 1. 🚀 Starters (Quick Start)
+*Standard templates found in `examples/starters/`*
 
 | Example | Description | Proficiency |
 | :--- | :--- | :--- |
-| **[Memory Driver Demo](./browser-demo/)** | Interactive task manager running entirely in the browser with in-memory storage. Perfect for prototyping and understanding ObjectQL's client-side capabilities. | 🌱 Beginner |
-| **[LocalStorage Demo](./browser-localstorage-demo/)** | Persistent browser storage that survives page refreshes. Ideal for offline apps, PWAs, and user preferences. | ⚡️ Intermediate |
+| **[Hello World](./starters/hello-world)** | **Absolute minimum.** A single TypeScript file using `ObjectQL` programmatically with an in-memory database. No config, no CLI. | 🟢 Basic |
+| **[Express API](./starters/express-api)** | **The Standard Server.** Shows how to mount ObjectQL onto an existing Express.js application as a middleware. | 🟢 Basic |
+| **[Basic Script](./starters/basic-script)** | A simple TypeScript script initializing ObjectQL with SQLite. Perfect for testing logic without a web server. | 🟢 Basic |
+
+### 2. 🧩 Module Architecture
+*Demonstrating the power of the new `modules` system in `objectql.config.ts`. See `examples/scenarios/`.*
 
-**Features:**
-- 🎨 Beautiful interactive UI with live CRUD operations
-- 📊 Real-time statistics dashboard
-- 🖥️ Browser console debugging (`window.app`, `window.taskRepo`)
-- ✨ Sample data generation
-- 🔄 Filter and manage data visually
+| Example | Description | Proficiency |
+| :--- | :--- | :--- |
+| **[Module Composition](./scenarios/module-composition)** | **[Code](./scenarios/module-composition)** <br> Shows how to mix **Local Modules** (`./src/modules/billing`) with **External NPM Modules** (`@objectql/module-auth`) in a single application. | 💡 Intermediate |
+| **[Enterprise Monorepo](./scenarios/enterprise-monorepo)** | **[Code](./scenarios/enterprise-monorepo)** <br> Organizing a large-scale application into domain-specific modules (CRM, HR, Finance). | 🏢 Advanced |
 
-## 🚀 Starters
-*Boilerplates and minimal setups to get you coding in seconds.*
+### 3. 📚 Tutorials (Step-by-Step)
+*Found in `examples/tutorials/`*
 
 | Example | Description | Proficiency |
 | :--- | :--- | :--- |
-| **[Basic Script](./starters/basic-script)** | A simple TypeScript script initializing ObjectQL with SQLite. Perfect for testing logic. | 🌱 Beginner |
-| **[Express API](./starters/express-api)** | A REST API server using Express.js + ObjectQL. Shows how to mount the server adapter. | ⚡️ Intermediate |
+| **[Task Manager](./tutorials/tutorial-task-manager)** | A simple Todo list app to learn objects, fields, and basic validation. | 🟢 Basic |
+| **[CRM System](./tutorials/tutorial-crm-system)** | A relational database example with Customers, Contacts, and Deals. Demonstrates `lookup` fields. | 💡 Intermediate |
+| **[AI Agent](./tutorials/tutorial-ai-agent)** | Integrating LLMs to query your data using natural language. | 🧠 AI-Native |
+| **[Formulas & Rules](./tutorials/tutorial-formulas)** | Using Excel-like formula syntax for computed fields and validation. | 💡 Intermediate |
+| **[Federation](./tutorials/tutorial-federation)** | Connecting multiple ObjectQL services together. | 🏢 Advanced |
 
-## 🧩 Plugins & Extensions
-*Learn how to extend the core capabilities of ObjectQL.*
+### 4. 🌐 Browser Demos
+*Run ObjectQL in the browser with no backend.*
 
 | Example | Description | Proficiency |
 | :--- | :--- | :--- |
-| **[Audit Log](./plugins/audit-log)** | A fully functional plugin that tracks changes (`afterCreate`, `afterUpdate`) and stores them. | 🔧 Advanced |
+| **[Memory Driver Demo](./browser-demo/)** | Interactive task manager running entirely in the browser. | 🟢 Basic |
+| **[LocalStorage Demo](./browser-localstorage-demo/)** | Persistent browser storage. Ideal for offline apps. | 💡 Intermediate |
 
-## 🏗 Scenarios & Patterns
-*Demonstrations of specific architectural patterns.*
+### 5. 🔌 Plugins & Extensions
+*Found in `examples/plugins/`*
 
 | Example | Description | Proficiency |
 | :--- | :--- | :--- |
-| **[Enterprise Structure](./scenarios/enterprise-structure)** | **[NEW]** Best practices for organizing metadata in large-scale applications. Shows domain-driven module structure with 20+ objects across CRM, HR, Finance, and Project modules. | 🏢 Advanced |
-| **[Module Usage](./scenarios/module-usage)** | Shows how to consume pre-packaged business logic (modules) in an application. | 💡 Intermediate |
+| **[Audit Log](./plugins/audit-log)** | How to write a generic plugin that intercepts `beforeCreate` and `afterUpdate` hooks to log changes. | 💡 Intermediate |
 
-## 🚧 Coming Soon
-We are working on high-fidelity examples:
-- **CRM System**: A Salesforce-like CRM with rich permission rules.
-- **E-Commerce**: High-performance catalog and order management.
-- **Next.js Integration**: Using Server Actions with ObjectQL.
-- **AI RAG Demo**: Semantic search connecting to OpenAI.
+### 6. 🛠 Integration Snippets
+*Standalone files in root `examples/`*
+
+| Example | Description |
+| :--- | :--- |
+| **[Existing Database](./connect-existing-database.ts)** | How to use Introspection to generate ObjectQL schema from an existing SQL database. |
+| **[Custom API Routes](./custom-api-routes.ts)** | Adding custom REST endpoints alongside the auto-generated ObjectQL API. |
+| **[Schema Migration](./schema-migration-example.ts)** | Programmatic usage of the migration system. |
 
 ---
-## How to Run
 
-Each example is a self-contained NPM package.
+## 🏃‍♀️ How to Run
+
+Most examples can be decoupled and run independently.
 
+**For Starters:**
 ```bash
-cd examples/starters/express-api
+cd examples/starters/hello-world
 pnpm install
 pnpm start
 ```
 
-- [ObjectQL Documentation](../docs/)
-- [Metadata Specification](../docs/spec/metadata-format.md)
-- [Metadata Protection Guide](../docs/spec/metadata-format.md#9-metadata-protection)
+**For Modules/Scenarios:**
+```bash
+# From root
+pnpm objectql dev --dir examples/tutorials/tutorial-task-manager
+```
+